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INTRODUCTION 



This edition of the Atlas Basic Language Programming 
Manual is a reprint of the version issued in January I965, 
A few minor corrections have been made to the text; a full 
set of amendments is included as an appendix to this volume. 
With the amendments, this edition covers all the facilities 
available to the ABL programmer up to June, I967; 

Chapter 10 has been issued as a separate document, 
"Preparing a Complete Program for Atlas 1", (list no; CS 46o/ 
TLI254), and this should be consulted for the latest informa- 
tion on job preparation; Supervisor logging at the end of a 
program (sec 11.1;3) is described more fully in Part One of 
the Atlas Operators* Manual (CS 4ll), 



D.E.C. 
June, 1967, 



PREFACE 



This manual supersedes the manual CS 348, "The Atlas Provisional 
Programming Manual", January 1963. It provides information for the 
progranmiing of the Atlas 1 computer in the language known as Atlas Basic 
Language (ABL)# It is a self-contained document, providing sufficient in- 
formation about the Atlas 1 computer to enable programmers to vrclte and 
develop programs in ABL without recourse to any other documents about Atlas i, 

The Atlas 1 Computer is the latest result of a long-standing col- 
laboration between Manchester University and Ferranti Ltd, A later version 
of the computer, known as Atlas 2, has been developed jointly by Cambridge 
University and Ferranti Ltd, In September 1963 the Computer Department of 
Ferranti Ltd., v/as acquired by I.C.T, Ltd., who now manufacture and market 
the Atlas computers. 

Atlas Basio Language (ABL) is a symbolic input language close to 
"machine language", Jilach ABL instruction corresponds to one cachine in- 
struction, and each part of an ABL instruction to each part of a machine 
instruction. In its simplest form an ABL instruction consists of four 
numbers corresponding ex&otly to the internal machine representation, but 
extensive facilities are also provided in ABL for the use of a variety of 
parameters and symbolic expressions which are evaluated by the ABL compiler, 
ABL also provides a comprehensive system of directives to control the 
assembly of a complete program. Finally ALL provides facilities for the 
input, conversion and storage of fixed-point numbers, floating-point num- 
bers and character strings for use by the program. 

In this mfinual no attempt is normally made to differentiate between 
those facilities which are a basio part of the machine (e,g, the instruction 
repertoire) and those which are a part of the particular language ABL 
(e»g, the formats for writing instructions). This is partly because it is 
impossible to separate them completely - anj^ feature of the machine itself 
needs a langixage in which to describe it, and in this case that language is 
ABL - and partly because it is not normally'" necessary or helpful for a pro- 
grammer to be conscious of the distinction* However, inasmuch as certain 
facilities of the machine itself are described here, parts of this m anual 
are relevant and interesting to users of other Atlas programming languages. 
In particular. Chapter 10 "Preparing a Complete Program" applies to all 
Atlas languages. 

A word must be said about the enumeration of binary digits: through- 
out this manual the convention adopted is to number bits as 0, 1, 2 ,,,,, 
starting always with bit number at the more significant end. This con- 
vention differs from that used in documents on the Supervisor and in engi- 
neering documents, in which only the accumulator is numbered as here, and 
in all other cases bit is the least- significant bit. 
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2000 » read »1000' 
30000' read ' 15000' 

are' read 'is' 

wherever' read 'whenever' 

a' read 'n» 

are' read 'is* 

of a' read 'a of 

ca:' read 'oa" 

when' read 'then' 

Ba» read'ba' 
y read 'bj' 

3V read '126' 

indictated' read 'indicated' 

10.6.2'read '10.6.1' 

is this case' read 'in this case' 

outselves' read 'ourselves' 



SPARE' read 
4' 



tape fail, TM TAPE FAIL, 



tape' read 'trap' 

Band Not Defined' read 'Band Not Reserved' 

pointing' read 'printing* 

500 a' " am •»- S ORE' read 
500 a' = am ♦ S QH' 
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Delete references to extracodes 1150, 1151 
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Ch apter 1 

AUTOMATIC DIGITAL COMPUTERS 

1.1 Introduction 

Atlas 1 is a very fast, automatic digital computer with built-in 
tir.ie- sharing facilities enabling a considerable number of problems to be 
processed simultaneously. This manual is intended for those who will pre- 
pare programs giving the machine detailed instructions for the step-by- 
step solution of individual problems. It is likely that they will have 
some previous knowledge of computers: should the ideas outlined in this 
cnapter be unfamiliar, the reader is advised to consult an introductory 
text for further clarificr.tion. 

1.2 Electronic Computers 

The application of electronics has led to the development of the 
modem high-speed computei^ v/e must distinguish two types of electronic com- 
puters : - 

Analogue computers represent quantities by some analogous physical 
quantity and solve problems by v/-orking with an actual physical model 
obeying the desired theoretical equations. Since the quantities involved 
can be evaluated only by measurement, the attainable precision is neces- 
sarily limited. The slide-rule is a f ainiliar example of an ooalogxie com- 
puter, using lengths to represent the logaritl'ims of numbers. 

Digital computers operate upon numbers in some coded-digit form 
and make use of standard computational techniques to obtain direct nu- 
merical solutions to problems. By increasing the number of digits with 
which numbers are represented in the machine, the precision, may be ex- 

uv^xjAx^u. n^uxxwvAW j,j.iuj.\i» A v^coxi. \j a-i-y^ ulj-o, ij\j j. md cu OJ.iu^a.c; J. i^ix iu vjx u-x^j-oeuL 

computer. 

1.2,1 Digital Computers . 

As a more cor^plete fom\ of digital computer, we may consider the 
combination of a desk calculator ejid its operator as a single computing 
unit; this will enable us to introduce the essential features of a typical 
digital computer; - 

(a) Input and Output. This is one of the roles performed by the operator 
of a desk calculator, who must set up numbers in the machine before they 
can be operated on and also read results from the machine, recording them 
elsewhere. For an electronic computer, information is transferred to and 
from the machine by automatic equipment. 

(h) Control* Here again, it is the operator who must control the se- 
quence of operations on a desk calculator, /ji automatic computer is con- 
trolled by a prograLi consisting of a sequence of detailed instructions in 
coded form. In the important C(,se of a stored-progTam computer, the whole 
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progrojn is stored within the machine before any of it is obeyed; the speed 
of the computation is then not restricted to that of the input devices. 

(c) Arit}wnBtio Unit* The nechanism of a desk calculator cairies out the 
individual operations in accordance v;ith the key depressed. Sioilarly, 
the arithmetic unit of an electronic computer performs the functions 
called for by the successive instructions in the program. There vrlll 
usually be included an accumulator in which the result of each step first 
appears, similar to the long register on the cai^iage of a desk machine. 

(d) Storage* The keyboard and certain other registers of a desk cal- 
culator constitute a working store, insofar as the mechanism of the 
arithmetic unit is able to operate directly upon numbers contained in these 
registers. An electronic computer commonly has a worlcing store capable 

of holding several thousand numbers. At any time each of these numbers 
is immediately available to the arithmetic unit, and so one speaks of a 
"random access" or "fast" store. 

This type of storage is relatively expensive and so if still 
larger amounts of storage are required this is normally provided by some 
cheaper fom of "backing" store. This V7ill inevitably involve a longer 
access time, but, Virhen required for computation, data can be transferred 
in blocks of several hiondred numbers at once from the backing store to the 
working store. 

1.3 Addresses 

Each of the locations in the backing store and in the computing 
store is assigned an address. The address is a number, and it is im- 
portant to distinguish the number which is the address of a location from 
the number which is contained in that location. As a means of distinction, 
V7C shall denote addresses by capital letters and contents by small letters 
and will assurue, for example, that the number s is the content of the 
location whose address is S. In certain contexts v^e shall find it neces- 
sary to use the notation C(S) as an alcemative to s. (Note that C(S +1) 
is not the sar.ie as" s + 1; the notation S* is sometimes used to denote 
S + 1, so that s* = C(S +1)). The contents of S after an opersiticn will 
be written s', so that, for example, the equation 

s' = s + b 

denotes the operation of adding the number b to the contents of S. 

1.4 Instruction Code 

V,'e have so far spoken of the contents of store locations as nur^bers, 
but they may also be instructions in coded forr.:. Both numbers and coded 
instructions may be referred to as "words"; it is for the prograsjmer to 
ensure that no attempt is made to interpret one type of word as the other. 
Mi instruction word will usuiilly contain one or more addresses to specify 
the data to be operated on; there will also be a coded number specifying . 
the operation to be performed. The correspondence betvTeen the elementary 
oper^utions which may be directly carried out in the arithmetic unit and 
the code nurabers which control them constitutes the "order-code" or 
"instruction- code" of the computer. 
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1«5 Junp Instructions 



Instructions v/ill generally be obeyed in the sp-me sequential order 
as their addresses occur in the store. However, it is possible to specify 
by an instruction the address of the next instruction to be obeyed, and 
hence one may arrange to "jump" out of sequence to an instruction at any 
desired address. Instructions are provided to make such a junp conditional 
upon the sign of certain nutibers in the machine; these conditionrJ jumps 
provide the ability to take elementary decisions. 

1.5.1 Looping , 

By repeatedly jiomping back to the same instruction, the coraputer can 
be made to obey a "loop" of instructions over and over again; this is a 
vital feature of high-speed computing, making it possible for a program of 
reasonable length to control the machine for relatively long periods of 
time. 

1.5.2 Modification . 

The utility of computing loops is greatly enhanced by the facility 
knovm as "modification", whereby different data is processed in each iter- 
ation of the loop. The store address of the number to be operated on is 
modified before use by the addition of an index stored in one of several 
special registers. Thus, if the index is increased by unity before each 
successive iteration, one may operate upon a list of numbers held in the 
store, and so, for example, form their sum or average. 

1.6 Binaiy Numbers 

The storage mechanisms used in electronic digital computers are 
normally made up of devices having tv/o possible states, just as a switch 
may be either OFF or ON. If we associate with these two states the 
symbols and i respectively, we are led to adopt the binary number system: 
the string of O's and i's stored on a rov; of two-state devices is inter- 
preted as a succession of coefficients of powers of two in a polynomial. 
This is exactly analogous to the conventional deodxial notation based on 
powers of ten. The binary digits and 1 arc comr.ionly referred to as "bits". 

1.6.1 Negative Number s . 

If a desk calculator is used to subtract some small niimbers from 
zero, the result is characterised by a string of 9's at the nore-sig-nificant 
end; the same operation with binary nurAbers produces a string of 1's. We 
have here a naturally occurring representation of negative numbers, which is 
made unambiguous by restricting the rtoige of positive ntir.ibers to those having 
as their most- significant digit. This then becomes a sign digit, and the 
presence of a i in this position will iMicate a negative number whose actual 
value is obtainable by subtracting 2^, r being the number of bits in the 
number. 
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Chapter 2 

THE i\TLAS 1 COMPUTER 

2«1 A General Description of Atlas 1 

The main prjrts of Atlas 1 consist of:- 

Thc control unit 

Two arithmetic lonits 

The Supervisor 

The storage system 

Input and output devices. 

2#1«3 The control unit produces in correct sequence the control signals 
necessary to call for an instruction, to decode it, to modify the address, 
to obtain the operand from store and to perform the arithmetic operation. 
The address of the current instruction is held in one of three special 
index registers, called control registers. Before the current instruction 
is decoded the contents of the control register in use are increased by 
one in anticipation of the next instruction, 

2.1.2 Arithmetic is mainly done in the accur.iulator, which is a double- 
length floating-point register. The accuiulator arithmetic unit can obey 
49 different instructions, including different types of addition, sub- 
traction, multiplication and division, transfers, tests, shifts etc. 

For small integer arithmetic, modification and counting, there are 
also 128 index registers. These are knovm as B- registers and have their 
own arithmetic unit. The B-register arithiietic unit can obey 51 different 
instructions, including addition, subtraction, logical operations, shifts, 
tests, counts etc. 

2.1.5 imy peripheral transfer on Atlas 1 has only to be initiated, after 
which it proceeds independently, leaving the central computer free to con- 
tinue obeying instructions. Suppose there to be only one program in the 
computer, which might be reading characters from the tape reader and sor- 
ting them on magnetic ta^e, one per word in units of 512 words. The tape 
reader operates at 300 characters per second and so reads a character 
once every 3,335 Tiicro seconds (ms)» a magnetic tape transfer of 512 words 
takes 46 milliseconds (ms). Between reading characters it would be pos- 
sible for the central computer to obey about 2,000 instructions, and while 
executing a magnetic tape transfer, about 50,000 arithmetic instructions 
could be obeyed. If the computer were to be idle during transfers because 
the information was wanted immediately (in the next instruction) obviously 
its utilisation would be veiy inefficient. Note that if the slow peri- 
pheral equipments could always transfer information at the rate required by 
the central computer for any problem no difficulty would arise. As they 
cannot, special operating methods have to be used. The method on Atlas 1 
is to have a special program called the Supervisor which controls the flow 
of programs through the computer. The Supervisor is simply a progran: which 
attempts to run Atlas in an efficient way, that is, it tries to keep all 
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the parts of Atlas busy« To achieve this, it shares oomputing time between 
programs, cjnd manages all peripheral transfers, including input and output 
as well as drum and magnetic tape transfers. The Supervisor is described 
in more detail later; at this stage it must be remarked that although it is 
not port of the "hardware" in the sense that the core store is, it is the 
most important single feature of Atlas and quite indispensable. 

2,i.4 The main store on Atlas i consists of core store in units of 8192 
words and magnetic drum store in units of 24,576 words. A total of about 
one million words are directly addressable. Up to 52 magnetic tapes can also 
be used as a backing store. The main store can consist of core store and 
drums in any proportion. The programmer treats the store as if it were all 
core store; he will in fact not know what parts of his program are in the 
core store at Bjn:y one time. The Supervisor manages dnom transfers behind the 
scenes as required, and attempts to keep the most used blocks of program al- 
ways in the core store, by means of a "drum learning" program. This idea of 
a fast and a slow store appearing as a single fast store is called the "one- 
level-store" concept. 

The Supervisor occupies most of a special store called the fixed store, 
and some blocks of the main store. The fisced store is a "read only" store in 
multiples of 4096 words where binary ones and zeros are represented by ferrite 
and copper slugs in a wire mesh. It is used to represent permanent programs 
which will not be changed, and besides the SuperTisor it holds the "extras- 
codes*. These are extensions to the basic instructions, described later. 
For working space the Supervisor has a subsidiary core store of 1024 words, in 
which it keeps parameters associated with programs in the machine, peripherals, 
etc. The Supervisor also uses three magnetic tape units, called "system 
tapes" as part of its input/output organisation. All the stores used by the 
Supervisor are known as private store, and it is not possible for ordinary- 
programs to inteirfere with them. 

2.1.5 A large variety of input and output devices are allowed on Atlas 1. 
I]ach type of device is connected to the central computer via the peripheral 
co-ordinator, which contains buffer registers and information registers con- 
cerned with the transfer of data. These registers, which are at different 
places in the computer, and also some registers connected with the arith- 
metic units, are collectively referred to as the V- store. They are only 
accessible to the Supervisor, and form part of the private store. The peri- 
pheral co-ordinator allows the following types of input/output equipments to 
be attached, 

IGT TR5 paper tape readers 300 ch/seo 

IGT TR7 paper tape readers 1000 ch/seo 

Teletype paper tape punches 110 ch/seo 

Creed 3000 paper tape punches 300 ch/seo 

Creed 75 teleprinters 10 ch/sec 

ICT card readers 600 cards/min 

ICT 582 card punches 100 cards/min 

Anelex line printers 1000 lines/min 

Graphical outputs 

Clock 
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The following diagroia shows the component parts of Atlas Is- 
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2.2 The Main Store 

Within the programmers store, registers ai'e numbered consecutively 
from upwar<i.s. Registers r.re aiTanged in blocks of 5i2 words called pages, 
and transfers bet\7een the core store and d ruins or magnetic tape take place 
in units of 5i 2-Trord blocks. To increase the computing speed, the core 
store is divided into stacks, each v/ith its own read/write circuitry. These 
ai-e known as the even and odd stacks. Each is of 4096 words and they ai^ 
arranged so that vrords 0, 2, 4, 6 ••.'. are in the even stack, v/ords i, 3, 
5 .... in the odd. Instructions are alivays called for by the control unit 
in pairs consisting of an even and the next odd instruction, although some- 
times only one of these instructions may be wanted. 

\Vherever it is safe to do so, as soon as the control unit has de- 
coded the odd address instru«tion it sends for the ne:ct paii'. Thus, there 
is overlap between the execution of instructions and it is in fact possible 
for the computer to be in different stages of execution of up to five in- 
structions. As a consequence, the first instruction in a pair must not 
alter the s econd, and t he second must no^ alter either of the next pair of 
instructions. HiZost always, if this were done, the unaltered versions 
would be obeyed, but because of "interrupts" which occur at frequent inter- 
vals and which effectively insert instructions between program instructions 
sometimes the altered versions vrould be obeyed. 
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Storage of information in Atlas 1 



An Atlas i register, or word, contains 48 binary digits. These are 
conventionally numbered from (most- significant) to 47 (least- significant). 

A single word can be used to represent any of the following;- 

(a) A 48-bit floating or fixed point number, with the 8 most- significant bits 
representing the exponent and the other 40 the mantissa. 



EXPONENT 



IviANTISSA 



7 8 47 

(b) Two 24-bit half-word numbers. These are taken usually as 21 -bit signed 
integers in digits 0-20, with an octal fraction in digits 21-23. 



20, 21-23 24 

(o) Eight 6-bit characters. 



44, 46-47 



D DZi ri2 r 



Q.^ 



5 6 



11 12 



17 18 23 24 



29 50 



35 36 41 42 47 



(d) An instruction, specifying a function P (most- significant 10 bits), 
two index registers Ba and Bm (7 bits each) and an address N (least- sig- 
nificant 24 bits). 



Q J L.>Ba___j L^L-J m. 



N 



9 10 



16 17 



23 24 



23 I 
47 



Throughout this manual the binary digits of a word are numbered 
from the most- significant end, starting with bit 0. The engineers' 
numbering system is the reverse of t his, and is used in some documents 
describing basic programs such as the Sirpervisor aiid -Engineers ' •progrsatttt 
in these documents bit is the least- significant bit. 
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2.4 Instructions in the machine 

N can be taicen as an operand directly in some instructions, in which 
case it is Imovm as n. l/'/hen N is used as an address, bits i-20 specify a 
word in the main store, bit 2i specifies a half-word address and bits 22 
and 23 specify a character address within a half-word (for the moment re- 
nuiiibering the bits of N as 0-23). Instructions ignore irrelevant digits 
in the address. Thus an instruction involving half-words ignores digits 
22 and 23 in the address. Digits 12-20 specify the v/ord address vdthin a 
block, and digits 1-11 specify the block. 

Thus a main store address consists of 
Block number \'/ord number in block Half-word address Character address 



-li 12 20 21 22 23 



For the moment mw shall write N as a decimal number and an octal 
fraction, separated by a point. Then 16.0 is the first half-word in word 
16 (i.e. digits 0-23) and 16,4 is the less-sij^-nificant half-vTord (digits 
24-47), in an instruction v/hich uses a half-word. In instinctions for 
handling characters, the characters in vrord 16 are 16t0, 16,1, 16,2, 
• •., 16,7; where 16.0 is digits 0-5, 16,1 is 6-11 etc., with 16,7 being 
42-47, 

The 10-bit function P is written as a single binary digit (fO) fol- 
lowed by three octal digits. For all basic functions fO is zero, and may 
be omitted in the vj-rittenform. The basic functions fall into three 
categories, depending on the first octal digit (f1 to f3)j if this digit 
is 1 , the function is a B-register instruction (B-code), if it is 2, the 
function is a Test instruction, and if it is 3, the function is an Accum- 
ulator instruction (A-code). 'These instructions are described in detail 
in later chapters. 

The basic order-code is extended by the provision of "extracodes". 
These are routines, written in basic instructions, which are positioned 
in the fixed store and which carry out many operations usually managed 
by a subroutine library. Extracodes are recognised by having f = 1 . 
When this is encountered, main control is halted and the progrem continues 
under a special "extracode" control at an address in the fixed store. 
The final instruction in this routine (y/hioh is recognised by f1 = f 3 = 1 
and obeyed as if f 1 =0) has the effect of returning to main control at 
the program's next instruction. ITius e:rtracodes are subroutines v^ith 
automatic entry and exit; to the programmer they appear as one instruction. 

For example. 

Function 113 is a B-code used to store a B-register 

234 is a test-code, transferring n to Ba if the 
contents of the accumulator are zero 

374 is an A-code, dividing the accumulator by the 
contents of a store address 

1250 is an extracode, to unpack a 6-bit character 
from store and place it in Ba. 
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The B-registers ore used in different ways depending on the type of 
instruction* There are 128 B-registers, BO to B127, most of them of 24 
bits. Bl20-i27 are special purpose B-registers, the rest are general pur- 
pose. In A-oodes, the contents of Ba and the contents of Bm are added 
to N to give a modified address. That is, the address S used in the in- 
struction is N^ba^bm• In most B-codes, ha is used as an operand, so only 
bm is used to modify N, and then S =3 N^bm. (There are two exceptions, in 
which bm is also an operand, so no modification takes place. ) For most 
test codes, bm is used as a further operaiid; where it is not it is used to 
modify N» In extracode instr;;otions. Ba and Bm are treated in a special 
way. For the present we shall v;r:.te Ba and Bm as decimal numbers in the 
range to 127. B- register arithmetic is described in Chapter 4. 
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n c 



The written form of Instructions 



Instructions are written on one line, v.-ith the component parts 
separated: 



Thus 



F 
113 



Ba 
1 



If b2 = 1 ,4 say, then 

113 1 2 

If b1 = 3^0 sa3^, then with b2 = 1,4, 

374 1 2 



16,4 stores b1 in the half ?/ord 
at address 16,4 (BO is 
always zero) 

16,4 stores b1 at 18,0 



16,4 divides the accumulator 
by the number at 21,0 



Instructions are read into Atlas throu£;h the media of punched paper 
tape, either of 5- track or 7- track width, and SO-column punched cards, 
7-track paper tape (the most common input medium) is prepared on a Flex- 
owriter, 5-track paper tape on a Creed teleprinter and cards on a card 
punch. These three equipments have sli{;jhtly different sets of characters. 
In the piinched form, the parts of an instruction are punched as v/ritten 
and separated by "multiple spaces" or commas. Multiple space is tr/o or 
more spaces on the teleprinter, or a tabulate (TiiB) on the Flexov/riter. 
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2,6 The Full Range of Atlas ^ IMressea 

As explained in 2.4, address bits 1 to 11 represent the number of 
512 word main store block to which that address refers, so that on Atlas 1 
main store address refers to one of 2046 blocks. In octal (for the J no- 
tation see 4,5) these block addresses are JOOOO, JOOOl , J0002,...., J3777 
and in their decimal representation (see 5,6) 0:, 1:, 2:^.,,, 2047:, The 
ABL compiler and the program it is compiling shore the same range of block 
numbers, with ABL occupying blocks in the range J3 to J34, Consequently 

of the 256 blocks 1536: to 1791; Once the program is compiled and ABL 
has withdrawn fiTom the store these blocks become available again and can 
be used as working space by the program. 

The remainder of the main store block numbers J34 to J4 are illegal, 
i\BL will not store program in block J3 or above and the Supervisor will 
fault the program if the oonipiled program attempts to refer to block J34 or 
above. 

In fixed store and private store addresses bit is a 1 • There are 
therefore another 2048 blocks that can be addi'essed and they have octal 
addresses J4000 to J7777. The first 16 of these (J4 to J4017) are the 
block numbers of the fixed store and may be referred to by the programmer 
if he wishes, although there is generally no reason why he should do so. 
The block numbers J4020 to J4777 are also quite legal. In effect these 
block numbers refer to 31 consecutively stored copies of the fixed store. 
For example either of the instructions 

101 3 J4017777 

101 3 -iJ5 

would place the same half-word in B3, namely the left half of the last word 
of the fixed store. In other words addresses in the range J4 to J5 are in 
effect masked with J401 77777 before execution (for a definition of masking, 
or what is the sane thing collating, see 4,3) 

The private store block addresses J5 through J7777 are completely 
forbidden to the oixLinary progranmier. These addresses can be referred to 
on extracode control. However it is impossible for the programmer to force 
an extracode to refer to the priviite store. He is prevented by faulting an 
extracode instruction in which the modified address is in the private store 
but the unmodified address is not. Thus for exaraple a program containing 
the instruction 

1730 J6 am' = sin (J6) 

would be thrown off because the first instruction of the extracode routine 

" 324 119 am' = (b119) 

(B119 will contain the address J6 upon entiy to the extracode. See 7,2.) 
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Chapter 3 

THE ACCUHUL/JTOR 

3.1 Floatins-point numbers 

'I'v'hen a 46-bit word is used to represent a number it is divided into 
40 bits for a signed mantissa a? and 8 bits for a sicned exponent y 



n EXPONENT ] n 



MiiOTISSA 



value 



1 7 8 9 47 

Digit is the exponent sign, digit 8 the mantissa sign. 
The exponent is an ootal one, so the number represented has the 

05.8^ 

The exponent is an integer and lies in the range 

-128 ^2/^127 

The mantissa is a fraction, with the binary point taken to be after 
the sign digit, so it lies in the range 



-1 < a; < 1 -ST 



39 



v/ith this system it is possible to represent positive or negative 
numbers whose magnitudes are approximately in the range 10"^^® to 10^^®# 

Sxample ; Gne way of representing tne number 8 is by a mantissa of 
+ 5 and an exponent of ^2, i.e# as ^ x 8^# Thus:- 

Estponent Mantissa 

OOOOOiO 0.001000000.,,. 000 

For clarity, when this is written in binary digits the exponent 
is spaced out away from the mantissa, the sign digits are slightly separa- 
ted from the numbers, and the mantissa binary point is shown. This con- 
vention will be used in future wdthout more explanation. 
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5.2 The AocumiiLator 

Floating-point arithiietio is all done in the full accumulator (A) 
aiid in order to describe the arithmetic it is first necessary to introduce 
the accumulator. 

The accumulator has an 8-bit signed exponent ay and a double-lengrth 
mantissa ace, of 78-bits and a sign bit. The mantissa Aa; is regarded as 
being divided into M and L, M being the sign digit v;ith the 39 more-signif- 
icant digits, and L being the 39 less-significant digits. Associated with 
L is a sign digit called Ls, Ls is situeted between M and L, and it is 
usually irrelevant; that is, arithmetic in the accumulator proceeds as if 
Ls is not present. 

The accumulator is sometimes regarded as holding two single-length 
floating-point numbers. These are called M and Al, 

Am consists of Ay and M 

Al consists of Ay and L with Ls 

There are a further two digits to the left of the sign of Am. These 
are the guard digits and their function is explained later. It is not pos- 
sible to transfer nimbers into or out of the guard digits, and before an 
accumulator operation they are normally'- copies of the mantissa sign digit. 

The exponent ay is held in the special B-register B-124, which con- 
sists only of nine digits at its most-significant end, the other digits 9-23 
being zero. The exponent is held in digits 1-8. Digit is used as a guard 
digit, to detect if the number departs from the range -'128 < ay < 127. Digit 
i is the sign digit and normally digit is the same as digit i . If the two 
digits are different, then the exponent has gone outside its permitted range. 
If d1 = 1 and dO = 0, then ay > 127; if ay > 127 at the end of an accumulator 
operation, then Exponent Overflow is said to have occurred and in some cases 
the program is monitored (see section 11.1.1), If d1 = and dO = 1 , then 
ay < -128; if ay < -128 at the end of an accumulator operation, then Exponent 
Underflow is said to have occurred and normally the contents of the accumu- 
lator are automatically replaced by "standard floating-point zero" (see 
section 3,3). 
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Diagrar. of the vvhole aooumulator 
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Diagram showine component parts of the aooumulator 
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Note that because of- the guard digit, the position of the exponent 
as held in B124, (digits 1-8) is different from the position of the ex- 
ponent for a number held in the store, which would be in digits 0-7. 

Aooumulator instructions usually involve arithmetic on two num- 
bers, one of these being in the accumulator and the other taken from the 
store# Most accumulator instructions deal with standardised numbers, so 
these will now be described. 



( 1.65 ) 



3.3/i 

5,3 Standardised nur;-bers 



The" representation of a floating-point nuuber is not xinique. For 
exanple | r= | x 8° ov-^ x 8^ or -tj? ^c 8" etc. so any of the forms below 
represent j. 

Exponent Mantissa Value = ^ 

0000000 000,100000000..., i X EP 

0000001. 000. 0001 00000..., rrr-x 8^ 

OOOOOdO ooo.ooooooioo.... -i. X 8^ 

jL 2 8 

(Note that the tv70 guard digits are shc-ivn to the left of the mantissa 
sign digit. 

It vvill be noticed that the VtuLue of a nunber is unchanged if unity- 
is added to or subtracted f2?om the exr^onent every time the mantissa is 
shifted 'octally' (by 3 bits) down or up, respeotirc^^jr. 

The optiniuin fonn of storage of a nunber in a binrjry floating-point 
system is that in v,-hich there are the ninirAUi:i nunber of O's (assuning a 

DOSitive nui.lber^ between +'hf=^ 'hinfn^r nn-in-h r>r>rl +^T^ mna+: c-i c«n-i-P-i /^pv,+- ^ /-.-*> 

the fractional pi.irt of the nunber. This enables the naximuni nuviber of 
fractional digits to contribute to the accuracy of the representation. 

As Atlas has an octal exponent, shifts of the nantissa nay only be 
by 3 bits at a time, so it is not possible to specify that there should 
be no o's immediately after the point. It is possible to specify a 
maxitiuni of two, and this is known as the stejidardised condition. A cor- 
respondins convention for a rdninua nunber of l's holds for negative num- 
bers. 

An x\tlas staiidaardised number is therefore such that the mantissa 
lies in the range :- 

r < a? < i or -1 < a? < -I 

and it uay be necessary to shift the mantissa of the number resulting from 
an operation up or down, adjusting the exponent accordingly, to achieve 
this. 

If a number is not standard it is either 'substandard' or 'super- 
standai^i'. A substandard number is one such thro.t -| < a; < 5. The three 
nrit significexit digits of aa; will be the same as the sign digit (and 
/<:uard digits), so the nuLiber can be strjidrj^dised by octal shifts up and 
adjustnent of the oxponent, A superstandard nunber is one in which the 
oantissa has overflov/ed into the sign and g-uard digit positions, i.e. it 
is > 1 or < -1 arxl it is detected by the gniard digits not being the sarae 
as the sign digit* To standardise such a nitriber, a single octal shift 
do',ra is required, v.dth the aidition of unity to ay. 
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Sxajngle: the addition of £ + £ with a standardising instruction 

6 8 

gives the correct result of + i standardised; though 
immediately pf ter the addition the number is supe3>- 
standard. 



£=:£ X 8° 
e 8 



S 8 

= i e1 X 8° 
i si. X af^ 

8 



(superstandard) 
(standardised) 



0000000 

0000000 

0000000 
000 0001 



ooo.ioiooo,. 

000,011000.. 

001.000000.. 
000.001000.. 



The number zero is a special case. Floating-point zero is repre- 
sented by a mantissa of and an exponent of -128, and this is regarded as a 
standardised number. Zero is specially looked for when a number is to be 
standardised, and, if found, no shifting taices place and the exponent is 
immediately set to to -128. 
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^•^ ^^g^-pQ^'t^ numbers 



For soue purposes it is inconvenient to deal with floating-point 
numbers, and accumulator instructions are provided which do not stan- 
dardise the results of operations. Using these instructions it is pos- 
sible to regard the binary point as being anywhere it is desired; for 
example, at the least significant end of M (which metJis regarding numbers 
in j\n as integers between the range of -2®° and 2^^® - i)» In this type of 
arithmetic, the exponents of the numbers oust all be the sane, and are 
comiiionly sero. If they are the same but non-zero, adjustments are re- 
quired Y/hen multiplications and divisions are performed, 

Superstandard numbers ca.nnot be automatically corrected in fixed- 
point working, so if they occur, a special Accumule.tor Overflow digit (AO) 
is set, and this digit can be inspected by the program, 

For example, if the point is taken at the least significant end 
of M, then the numbers in the last example, | and |, now iiave the values 
(2°® +2^®) and (2'^''' + 2^^), Mding them gdves a superstandard answer 
and sets AO. 
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3«5 Rounding 

Most aocunulQtor instructions operate on the two numbers cm and s, 
leaving the answer in A# This onsvver acj be an operand in the next instruc- 
tion with onl^ am used, the digits in L being cleared before the operation. 
The process of cutting off these less-significant 39 digits of the answer is 
called truncation, and this introduces on error each tine which could quicldjr 
become significant. Rounding is the name given to the p2X)cess of compensating 
the answer so as to minimise -Uie effect of truncation. 

One method of rounding; is to force a 1 (i»e» tlie logical "OR" op- 
eration) in the least significant digit of M if 1 is non-zero/ If 1 is zero, 
no forcing takes place. In a sequence of accumulator instructions, the a- 
verage error introduced by this method is zero, so no bias is introduced. 

Further, single-length integer arithmetic in Am con be carried out 
exactly vrilthout any unv/anted rounding, as long as numbers never extend into 
L. The abbreviation R is used in describing some instruction to signify 
rounding in this way. Notice that L is not changed by the process of roun- 
ding. 

An instruction is also provided to give rounding by adding a one to 
the least- significant dig-it of M if the most- significant digit of L is one. 
Again, the digits of L are left unchanged. This type of rounding is referred 
to as R+ Rounding. It is sometimes preferred to the method just described 
as less accuracy is lost, but is slightly biased in that the roundin{; is al- 
ways upwards in the halfway case of L being a b inaiy one followed by a string 
of zeros. 
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5»6 Floating-point operations 

Before two ntmbers in floating-point forn oaji be added the nunbers 
must be shifted relative to each other so that di^dts which have the same 
significance can be added together, i.e. one niJEiber is shifted octally until 
the two exponents eire equal. 

In Atlas, the nimber which has the smaller exponent is the one that 
is shifted, and it is shifted down into L, irrespective of whether it is the 
number in A or the number in S. There are four addition instructions, and 
of these, three clear L before this shifting takes place, so the addition is 
between an and s. 

Ay is then set equal to the larger of the two exponents and the ar- 
guments are added together. The addition takes place over the 42 digits of 
M with its guard digits. L remains unchanged during this stage. 

After the addition^ the accumulator nay be standardised and rounded, 
standardised but not rounded, or left unstandardised and unrounded, depending 
on the instruction. The instructions vvhich standardise check that exponent 
overflow has not occurred, the instructions which do not standardise look 
for accumulator overflow. 

The addition instruction which does not clear L first is used mainly 
in doiible-length arithmetic. To work correctly, the exponent of s must be 
equal to or greater than ai/. so that the contents of the accumulator are 
shifted down. If sy < ay, then s would be shifted down into L* overwriting 
the original contents of L. 
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5«7 St andardi sing and rounding accumulator instructions 

We are now in a position to introduce some accumulator instructions* 

Function Description Notation 

520 Clear L; add the c ontents of S 

to the contents of Am; standardise 

the result, round by forcing a i 

into the least- significant bit of 

M if 1 is non-zero and check for 

exponent overflow. am' =: am + s QRE 

32i As 320 but subtract s am' =^ am - s QRE 

322 As 320 but first negate the 

contents of A am' = -am + s QRE 

324 Transfer the floating point 
number in S to Am and 

standardise it am' = s Q 

325 As 324 but transfer negatively 

and check for exponent overflovr rjn' = -s QE 

356 Store am at S, leaving the 

contents of A unchanged s' = am 

362 Clear L, multiply am by s, 
standardise, round and oheok 

for exponent overflovr am' = am»s QEE 

363 As 362 but multiply negatively am' = -am.s QRE 

374 Divide am by s, leaving the quotient 

standardised and rounded in Am, 

with l' =s 0, Check for exponent 

overflow and division overflow. 

Both am and s must be standardised 

numbers am' = am / s 

1' = u 
QRE DO 

0?he above are the most commonly used accumiilator instructions, all 
but the 356 instruction leaving a standardised rounded number in M* 

Example t given fo\ir standardised floating-point numbers a, b, c, 
d in the first four locations of store, replace a by 
(a-b^o)/d'» 

324 3 put d into M 

362 3 form d^ 

356 4 store in location 4 

324 a into jto 

321 1 subtract b 

320 2 add c 

374 4 divide by d** 

356 store answer in word 

Note that register 4 is used as working space, and that Ba and Bm 
are aero in every instruction. 
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^•^ "^^Q timing of instructions 

In general, it is not possible to state exactly hov/ nuch time any 
instiniction will take, because this partly depends on the instructions be- 
fore and after it# However, in a sequence of additions, subtractions or 
transfers each uniuodified instruction talies about i .6 |is. If modified by 
bm, the time is 2»0 /iS, and if modified by bm and ba the time is 2.5 ^jS, 
The times for multiplication and division are 6,0 jjs and about 20 jtis res- 
pectively. The division tine depends on the numbers involved. However, 
another limitation on the speed is the time needed after reading a number 
from a stack of core store before another number can be read from it. This 
is known as the cycle time of the store and is 2 /iS. liS alternate addresses 
are in the even and odd stacks, (see section 2.2) if operands are used in 
sequence then the cycle time is not a limitation. In the exaiiple just 
quoted, the sixth instruction would take 2 ns because the next instruction 
cannot read its operand until this tine is up. In the fifth and sixth 
instructions the opereinds are in different stacks so the siibtraotion would. 
take 1.6 ^s. B- register instructions, as they use a different arithmetic 
unit, can continue v/hile the accumulator is busy. During a division in- 
struction, for exai-iple, three or four E- instruct ions might be completed, 
effectively telcing no time at all. 
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3.9 Sone fixed-point Inetruotions 

Fixed-point working has been introduced in section 3.4 
Function Description Notation 



330 



ss-l 



Clear L, add s to asi, leaving the 

result in A. Do not standardise or 

round but check for accumulator 

overflow a' = am + s AO 



332 As 330 but nef-^ate am before the 

addition a ' = -aii + a AO 

In these ins trv'-ct ions, if the exponents are the sane, no stiifting 
down of either of the numbers into L takes x^lace, so the answer will be in 

Am. 

334 Transfer s into ika v/ithout 

standardising an' =: s 

335 Transfer the nmbcr in S 
negativel;/ into An without 
str.ndardisin£;, and check for 

accunulator oveiTflow an' =: -s AO 

In 335 AO would be set if s is just a one in the sign position 
(which we will call -i.O) as negating; this sets the sign dis-it different 
fron the guard digits. 

364 Shift the mantissa up one octal 
place, leaving the exponent unchanged. 
Accunulator overflow can occur, but 

no check is nade aa' =s Qax 

^y =» ay 

365 Shift A« down one octal place, 

^y =» ay 

The above two instructions are of course also useftil in floating- 
point arithnetic, to multip3o^ or divide by 8. Extraoodes ai^ provided to 
shift any specified nunber of places up or down. 
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Chapter 4 

THE B-SSGISTilRS 



The irdex registers, or short accumulators, are known as B- registers 
on Atlas, There are i 28 B-registers. 120 of these are constructed from a 
very fast core stoi^ and are used for general purposes. The remaining 8 
are "flip-flop" registers, used for special purposes. The B-registers have 
addresses from zero to 127, and are referred to by prefixing the address 
with the letter E or b» Thus 361 is B-register with address 61 and bel is 
the contents of this B-register, 



4,1 General Purpose B-registers 

These are the first 120 registers BO to B119, Each consists of 24 
bits of which the most significant (digit 0) is taken to be the sign digit. 
For purposes of mod:i'ioation and counting, integers are held one octal 
place up from the least-significant end of a word, so the binary point is 
assumed to lie between digits 20 and 21. Thus a B-register can hold a 21- 
bit signed integer with an octal fraction. 

The contents of a B-register are usually written as a signed de- 
cimal number and an octal fraction, the two parts separated by a point. 
Thus 15.3, -2,7, 6,0 etc, V-Tien the octal frr,ction is zero it is usually- 
omitted, the point of course also b eing omitted. The number in a B-register 
can take any value in the range -2^° to ^s'^° -0,1 inclusive. An exception 
is 30, whose contents are always zero. 

1^ 

Programmers are warned to refer to section 4,10 before using B81- 
119, whose contents ai^e liable to be overvvritten. 

The basic instructions which operate on B-registers have already 
been mentioned. They are known as B-oodes and B-Test codes- and ?;ill now 
be described in detail. 
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4-. 2 Arithmetic Operations 

■ ■ I " ' * ■' * ■ I III nm III 

In the following instructions, arithmetic takes place between a 
24-bit number in the store and a number in the Ba B«register« The address 
is modified by the contents of Bm, the other B-register, to give the half- 
word store address S of the operand. The contents of this are known as ^# 



Function 


Description 




Ifotation 


101 


Transfer s to Ba 


ba 


' =3 s 


103 


Transfer s negatively into Ba 


ba' 


' = -s 


104 


Add s to the contents of Ba 


ba' 


' =! ba + s 


102 


Subt-^aot s from ba 


ba 


' = ba - s 


100 


Negate ba and add s to it 


ba' 


= -ba + s 


111 


Store ba negatively at S 


s' 


= -ba 


113 


Store ba at S 


s' 


ar ba 


114 


Add ba into the contents of S 


s' 


=: s + ba 


112 


Negate the contents of S 








and add ba 


s' 


== -s + ba 


110 


Subtract ba from the contents of S 


s^ 


= s - ba 



Jixam' 



nple: 



101 

113 
102 
114 
114 



If m is held at address 5,4 and n at 6,4, place 2a - 2n 
at 6, using B1 as working space. 

5,4 transfer m to B1 

6 store ra in half-word 6,0 

6,4 m - n in B1 

6 2m - n in 6 

6 3ci - 2n in 6 



There are instructions provided which use the address as an 
operand. That is, N +bn,^ instead of giving the address of the operand, 
is used directly as a number n. 



Function 
121 
123 
124 
122 
120 



Description 
Place n in Ba 
Place a negatively in Ba 
Add n to the contents of Ba 
Subtract n from ba 
Negate ba and add n 



Notation 
ba' = n 
ba' = -n 
ba' = ba + n 
ba' = ba - n 
ba' r=s -ba + n 
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Exacaples ; 



1« Replace the nui.iber m in 17.4 by the nutiber 64 - n 
i2i 1 64 put 64 djito B1 

1i2 1 17.4 -n + 64 in 17.4 

2. Copy the nmiber in B2 into B3 

121 3 2 b3' = +b2 

Tliis has the effect of placing 0, nodified by the contents 
of B2, into B3 i.e. places b2 into B5. 

3. Similarly, the number in B4, for example, can be doubled by 
the instruction 

124 4 4 b4' =b4 +b4 ♦ 
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4r,3 Logioal Operations 

Three types of logioal operations can be carried out in B-register 
arithmetic. These are collating, non-equivalencing cjid "OR" ing. They 
operate on pairs of nianbers simply as strings of binary digits, and form 
a third number from the pair. 

The collate operation, which is denoted by <£, gives a i in the 
result in every position where both numbers have a i, and O's elsewhere. 
Per example, the result of collating 

00010110 

with 0111 0100 

is 00010100 

The non- equivalence operation, denoted by ^ gives a 1 in the posi-^ 
tions in which the corresponding digits of t he two numbers differ, and 
O's elsewhei*e. 

The result of non-equivalencing 

00010110 
with 01110100 
is 01100010 

The OR operation, denoted by v, gives 1 in those positions in v^hich 
either (or both) of the corresponding digits of the two numbers is a 1, and 
s elsewhere. 

The result of ORing 





00010110 






with 01110100 






is 01110110 




Function 


Description 


Notation 


107 


Collate the digits of Ba with 






the digits of a placing the 
result in Ba 


ba' = ba <& s 


106 


Non-equivalence ba with s, 
placing the result in Ba 


ba' = ba ^ s 


147 


OR ba with s, placing the 
result in Ba 


ba' = ba V s 


117 


As 107, but placing the 
result in S 


s' = s <£• ba 


116 


As 106, but placing the 
result in S 


s' = s ^ba 


127 


Collate ba with n, placing 


- 




the result in Ba 


ba' = ba <S- n 
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^^ction Besoription Notation 

1 26 Non-equiveienoe ba with n, placing 

the result in Ba ba' == ba j^ n 

i67 OR ba with n, placing the result 

in Ba ba' = ba v n 

3xar.:ples: 

1# Clear the most- significant 17 bits of B99 and leave the other 

127 99 "15.7 Collate b99 with a number consisting 

of ones in the 7 required positions, 

V/hen n is used in this 7/ay it is called a "mask". It is 
often inconvenient to have to work out masks as decimal nur.ibers 
vj-ith an octal fra,otion, so other ways of v/ritiiig the address are 
allowed. 

For exacple, if it is required to leave the r.ost- significant 7 
bits unchanged and to clear the rest of B99, then the 2iask required 
consists of ones in the 7 iV.ost- significant positions (0 - 6), 

The two letters K and J introduce nur.'bers written in octal 
notation. 

K, followed by up to seven octal digits, positions the nui.ber 
froz digit 20 upwards. Thus^ K 5642 places the number 00036420 in 
the address position. Octal zero's at the :;.ost- significant end 
uay be onitted, and the least-significant octal fraction if present 
has to be separated fron the nui'iber by a point, e.g. K5 252525. 2 
fills the address digits with alternate ones and zeros, 

J followed by up to eight octal digits, has the effect of con- 
piling these di-?its froo the most— si^-'nifioant end, 'Phat is the 
first octal digit goes into bits 0-2 the next to 3 - 5 etc. 
Less-significant zeros may be ondtted. Thus Ji42 places the num- 
ber 14200000 in the address digits, 

2, To leave the most- significant 7 bits of B99 unchanged and to 
clear the other digits 

127 99 J77i collate b99 with a uask consisting 

of ones in the top 7 j)Ositions, 

3, Replace the nuLiber in B62 vn.th a nuiiber such that where there 
were ones there are now zeros and w^here there were zeros there are 
now ones. This is known as the 1's oonnpleinent 

126 62 J77777777 non-equivalenoe with a cask con- 
sisting of all ones. The nask 
could also be written K77777y7.7 
or - 0,1 
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Forming the i 's complement of a number is often not so simple 
as in tliis example, so the operator '(prime) has been provided. 
Aixy number followed by ' is interpreted as the i's complement of 
that number. Thus the instruction could have been written 

i26 62 0' 

There are two other logical instructions on Atlas, and these use 
bm as a further operand. 

Function Description Notation 

165 Collate bm with n and place 
the result in Ba, leaving 
bm unchanged ba' — bm cS: n 

i64 Collate bm with n and acid 

the result into Ba, leaving 

bm unchanged ba' = ba + (bm & n) 

Note ; If Bm is BO in the 1 64 and i 65 instructions , then bm & n 
gives n rather than 0. 

Example ; AM. the 6-bit character in digits 6 - i1 of Bi into B2. 
164 2 1 J0077 
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4»4 Tcs"t Ins'tjmo'ti.ons 

The following- test instructions test bm, and transfer n into Ba 
if the test succeeds, n cannot be modified as bm is used. If the test 
faiisj ba is wioliancod- . 

Function Description Notation 

214 nf bm is zero, place n in Ba If bm » 0, ba' = n 

215 If bm is not zero, place n in Ba If bm ^ 0, ba' == n 

216 If bm is ^-reater than or equal to 

zero, place n in Ba If bm > 0, ba' =i n 

217 If bm is less than zero, place 

n in Ba If bm < 0, ba' = n 

These tests can be used with any B-registers but are most often 
used to cause a change of control if a certain condition is satisfied, 
so the control registers will now be described. 

There are three control registers, only one of which is in operation 
at any given time. These are called main control, extracode control and 
interrupt control, and are the three special B-registers B127, B126 and 
B125 respectively. When a program is being obeyed, the address of the cur- 
rent instruction is held in the relevant control register. The control 
register is increased by one just before the instruction is obeyed in an- 
ticipation of the next instruction. Ordinary programs can use only B127, 

Unconditional jumps to some address S are effected by placing this 
address in the control register 

■^21 127 5 causes the following instructions 

to be taken from location 5 onwards. 

Example: Two numbers a and b are in locations 14 and 14.4. A 
program which r equires these numbers is in locations 
from 100. 

Ifa<0, b>0 enter this program at register 100 
a < 0, b < " " " " " 101 

a ^ Oy b ^ " " " " " 102 

a > 0, b < " " " " « 103 

The program is 7 instructions long; let it occupy the first 7 
registers of store. 



place a in B1 

place b in B2 

if a > 0, jump to register 5 

if b < 0, jump to 101 

if not, a < 0, b > so jump 

to 100 

if a > 0, b > 0, jump to 102 

if not, a > 0, b < 0, so jump 

to 105, 

When writing a program it is helpful to show the possible routes of 
jumps with arrows. Unconditional jumps az^ often underlined, to isaiicate 
a definite break in control, 
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ister 






Contents 







101 


1 





14 


1 


101 


2 





14.4 


2 


r216 


127 


1 


5 


3 


217 


127 


2 


101 


4 


121 


127 





100 


5 


.216 


127 


2 


102 


6 


121 


127 





105 



4r#5 Special Purpose B~re£pLsters B120»B127 

Although it is not necessary for the ordinaiy progracuiier to know 
about many of these special-purpose B-registers, details of them are given 
here for the sake of completeness • 

It has been mentioned that there are three control registers, B125, 
B126 and B127, which are called inteirupt control (I), extracode control 
(E) and main control (M) respectively. Ordinary programs use Bi27, and ore 
prevented fron having access to the subsidiary store and V-store. 

Interrupt control is used in short routines within the Supervisor, 
which mainly deal with peripheral equipments. These routines are entered 
automatically whenever any peripheral equipment needs attention, e.g. when 
a tape reader has read a character. Occasionally the Supervisor will need 
to enter relatively longer routines to deal with the cause of interruption, 
e.g. on completion of the input of a paper tape, "im^ilst in interrupt con- 
trol, further interrupts are not possible, so control is switched to extra- 
code whenever the Supervisor enters a more lengthy routine. Both I and E 
control allow the Supervisor access to all the machine, but extracode con- 
trol programs can also be interrupted and restarted in the same way as 
ordinary programs'. 

Extracode control is also used when any of the 300 or so subroutines 
in the fixed store are being obeyed. These subroutines have caitomatic entry 
and exit and are known as extracodes- When an extracode instruction is en- 
countered, the relevant subroutine entr^'- is placed in Bi26 and control 
switched to E. iifter the final subroutine instruction control is re switched 
to M which holds the address of the next pi\)gram instruction, (The current 
control register is always increased by one before the instruction is obeye<^ 

B124- has been introduced as the aocumulator exponent a^^ It consists 
of onl^^ the 9 most significant digits (0-8) the remaining 15 being always 
zero. Exponent arithmetic can be carried out by using B-code instructions. 
When this is done care must he taken to position exponents correctly in the 
digit positions 1-8 and to set the guard digit (bit 0) correctly. 

Example ; 

121 124 J004 sets the exponent to ^4 

3123 is a B-register with the special property that a number read 
from it, instead of being the number last written to it, is the character- 
istic of the logarithm to base tv/o of the eight least- significant digits of 
that number. 



( i.66 ) 



4.6/2 



Input to B123 Output from B123 

Digits 0-i5 16 17 18 19 20 21 22 23 0-16 17 18 19 20 21-23 

so 00000001 0000 

ffl OOOOOOIa? 0001 

X OOOOOlajaj 0010 

X OOOOIafajoj 0011 



X 








1 


X 


X 


X 


X 


X 








1 





1 





X 





1 


X 


X 


X 


X 


X 


X 








1 


1 








X 


1 


a? 


X 


X 


X 


X 


X 


X 








1 


1 


1 





X 





























1 















Using B123, the Supervisor can identify the exact cause of an in- 
terrupt as a resiolt of obeying from two to six instructions. 

The programmer cannot use B1 23 directly because of the danger of an 
intervening interrupt which would alter the contents before they could be 
read out. A similar warning applies to B125, B126 and to all the B-registers 
B100-B118. 

B122 and B121 are again D-registers provided with special circuitry. 
Their function is to allow indirect addressing and modification of the Ba 
operand in an instruction. 

B121 behaves as a normal B-register except that it consists of only 
seven digits (15-21), the remaining bits being always zero. These seven 
bits allow B121 to hold any of the numbers 0, 0.4, 1, 1.4, •... up to 63.4. 
When B121 is used in conjunction with B122 its contents are interpreted as 
the address of a B-register in the range 0-127. That is, 0.4 sB1, 1 s B2, 
• •••.. up to 63.4 =B127, the B-register address starting from digit 15. 

B122 is called the B-substitution register, which gives an indi- 
cation of its function. IfVhen B122 is encoimtered as Ba in an instinjction: 

(a) the contents of B121 are taken as a B-register address, Ba; say. 

(b) the instruction is then obeyed as if the B-register specified in the 
Ba position was Bai. 

A few examples will maloe this clearer. 

Example 1 

121 121 8.4 sets b1 21 sB1 7 address 

121 122 1 will place the number 1 in B17 
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Sxample 2 

It is required to copy the contents of B87 into B80, B76, B72 
and so on (every fourth B- register) lecivingthe other B-registers 
unchanged. 

This could be done by the sequence of instructions 

i21 80 87 copy B87 into B80 

121 76 87 

121 72 87 

121 68 87 

etc. «•••••• ••••• for 19 instructions in all but by using 

B121 and B122 we cixn. write a short loop of instructions. 

6 121 121 40 set address of B80 in B121 

7 121 122 87 copy b87; into B80 first tdjne 

B76 second tine etc. 

8 122 121 2 subtract 4 from the B- address 

9 215 127 121 7 if bl21 ^ 0, jump to the in- 

striaotion in location 7 

When b12l = the jump does not take place, and the program 
proceeds to the next instruction. 

B121 and B122 play an important part in the exbriicodes. "When an 
extracode instruction is met, just before control is switched to extracode, 
the Ba digits in the instruction are copied into B121. This allows the 
extracode routine to operate on Ba by using B122. B-register 119 is also 
set up in a special wa^'' when an extracode instruction is met, to enable 
the extracode routine to obtain the store operand involved. This is des- 
cribed later. 

In between a program's extracode instructions the programmer is able 
to use B121, B122 as he likes, but caution must be exercised to avoid inad- 
vertent over-writing of their contents when an extracode instruction is 
called for. 

B122 only operates as the B- substitution register when it is in the 
Ba digits of an instruction. In the two other circumstances possible, its 
value is zero. These are: 

(a) Bm specified as B122 

121 1 122 alwa;j''s puts zero in B1 

(b) Using B122 as Ba when the contents of B121 are 61, i.e. B121 is poin- 
ting at B122 

121 121 61 setb12lsB122 

113 122 100 writes the number zero into store 

location 100 
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Ajny number written into B120 is displayed as 24 digits on neon 
lamps on the engineers console. Thus:~ 

"^21 i20 J52525252 displays alternate ones 

and zeros 

The engineers console is not normally available for use by the 

programmer, 

....'u'^^'w T x^^ J. « .i.t3 ^uui^iuu uou. ij\j X ctau, A iuiu JD s 4SU - T-ii© numcer r'^acL out 
always zero. 
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^•6 Modifioation/Ck)uating Instructions 

The technique of modification has already been introduced. 

In Atlas instructions, the contents of any of the B-registers not 
directly concerned in the operation may be used to modify the address. 
Thus, the instruction 

324 3 iOO 

copies the contents of location (iOO + b3) into the accumulator (and stan- 
dardises the result). 

Suppose we have 20 unstandardised floating-point numbers stored in 
locations i 00-1 19, arui it is required to standardise these nxambere and re- 
store them in the same locations. A program to do this might be as follows:' 

set 19 in B3 

am' = s, standardised 



10 


121 


3 





19 


11 


324 





3 


100 


12 


356 





3 


100 


13 


122 


3 





1 


14 


216 


127 


3 


11 



s' = am 



subtract 1 from b3 

jump to location 11 if b3 > 

B3 is used as the modifier and to ensure that the loop is cycled 20 
times. This latter process, counting, is of such frequent occurrence th«,t 
eight basic counting instructions have been provided. 

The most important of these are:- 
Function Description Notation 

200 If the contents of Bm are non-zero. If bm y4 0, 
add 0.4 into Bn and place n in Ba. bm' == bm +0.4 
If bm = 0, bm and ba are unchanged. and ba' = n 

201 As 200 but increase bm by 1 If bm ^^ 0, 

bm' = bm +1 and 
ba' = n 

202 If bm is non-zero, siabtract 0,4 If biii ^ 0, 
fron it and place n in Ba bm' = bm - 0.4, 



ba' 



-n 



203 As 202 but s\ibtract 1 from bm If bm ^^ 

bm ' = bm - 1 , 
ba' = n 

Note: About instructions 200, 201 , 202, 203 : If Ba and Bm are 
the stone B-line and the test succeeds, its final contents 
are n. If Bm is B127 (and Ba is not), these instructions 
give an unpredictable result. 
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The laat two instructions in the example above -uould be replaced by 

205 127 3 11 If bS^^O, b5' =b3 - 1 and b127' = 11. 

i.e. jiunp baclc with bS reduced by one. 

Examples ; 

1. At the addresses 50-99.4 inclusive there are 100 half-words. 
Find how many of these numbers are zero and leave the ansr;er in E7. 

"^21 7 strjrt count of numbers = 

^ "ISI 2 49,4 set count/modifier in B2 

2 101 3 2 50 number to B5 

215 127 3 5 jump to 5 if b3 ^ 



3 



4r 124 7 1 if b3 = 0, add 1 to b7 

5 202 127 2 2 count 

2. To clear the B- registers B1 to B100 

121 121 50 set count/modifier in B122 

1 121 122 clear BlOO first time, then B99 etc. 

2 202 127 121 1 count reducing b121 by 0,4 each 

time aiii jump back 
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4,7. The B»test BegLster 

The B-test register Bt oonsists of two digits only# 

Y^en a number "is written to Bt, one of these digits is set to show 
whether the nimber is = or ^ 0, and the other to show whether it is > 
or < 0. 

Instmctions are provided to write numbers to Bt, to test the above 
mentioned conditions, and to count. These aret- 

Punction Description Notation 

i52 Set the B-test register by writing 
to it the contents of Ba minus the 
contents of S. ba and s are 
unchanged. bt' sba - s 

150 Set Bt by writing s minus ba to it. 

s and ba are unchanged. bt' s s - ba 

1 72 Set Bt by writing ba minus n to it. bt ' aba - n 

170 Set Bt by writing n minus ba to it. bt' s n - ba 

224 if Bt is set equal to zero place 

n in Ba If bt = 0, ba' = n 

225 If Bt is set not equal to zero 

place n in Ba If bt ^ 0, ba' = n 

226 If Bt is set greater than or equal 

to zero, place n in Ba If bt > 0, ba' = n 

227 If Bt is set less than zeix), place 

n in Ba If bt < 0, ba' = n 

220 If Bt is set non-zero, place n If txb ^ 0, 

in Ba and add 0.4 to bm. If Bt bm' = bm~ + 0.4 

is set- zero, do nothing and ba-' = n 

221 If bt ^ 0, place n in Ba and add If \yb :^ 0, 

1 to bm bm' i= bm + 1 

ai^ ba-' = n 

222 ils 220 but subtract 0.4 If bt ^ 0, 
from bm bm' = bm~- 0,4 

and ba.' = n 

223 I-xB 221 but subtract 1 If bt ^(^ 0, 

bm' = bm"- 1 
and ba' = n 

rfote: In instructions 220, 221, 222, 223 , if Ba and Ba 

are the same B-line and the test succeeds, its final contents 
are n. If Bm is B127 (but Ba is not), these instructions 
give an unpredictable result. 
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Bt is not directly addressed; Bt instructions are recognised by 
the function digits. The instixu>ti»iis to set Bt ai*e useful for comparing 
numbers, as the operands are not altered. 

The conditional transfer instructions, 224-227 ai^ used to cause 
a conditional jump, and as bm does not take part in the instructions it 
can be used to modify n, giving a modified address for the conditional 

jump. 



TA. -I 



In 100 to 199,4 inclusive there are 200 half-words. Find the 
lowest address of this range which contains the n^mber -3 and store this 
in 99.4, If no such number exists, set 99,4= -0,1 

"121 1 -5 set required number in B1 

1 121 2 100 first address in B2 

2 152 1 2 bt' =ba - s 

3 224 127 7 jump- if bt - 0, i.e. s = -3 

4 170 2 199.4 bt'=J99.4-ba 

5 220 127 2 2 if bl; 9^ 0, 

b2' = b2 + 0,4, jump back 

6 121 2 -0,1 if search fails, set -0,1 

7 113 2 99.4 store result 



( 1,65 ) 



4.6/1 



4.8 



The Shiftins Instructions 



Four instructions are provided which shift the number in Ba. These 
shifts are either of six places up or of one place down, and are circular 
shifts • That is, digits which are shifted out of the register at one end 
re- appear at the other end. 

The main purpose of these instructions is to assist in the manipu- 
lation of 6-bit characters and to provide ways of shifting ba any specified 
number of places. 



Function 
105 



125 
143 



163 



Description 

Shift ba up 6 places, copying 
the initial 6 most-sitvnificant 
bits into the least- significant 
6 bits, then add s into ba 



Shift ba as in 105, then add n 



Shift ba down one place, copj^-ng 
the initial least- significant 
'1 "1 cT + -1 Tvt-Q +Vi<a ji<>w niost— si''*nif i— 
cant position, then subtract s 

Shift ba as in 143, then 
subtra,ct n 



Notation 



ba' = 2%a. + s,- 
(cir-Gular shift) 

ba' = 2%ix + n, 
(circiilar shift) 



ba' = r^ba - s, 
(circular shift) 

ba' = ST^ba - n, 
(circular shift) 



These basic instinicticns are intended to be used by extraoodes 
which provide more useful shift functions. 
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4:. 9 The Odd^Even Test Instructions 

Tv70 further test instructions can be used to test the least- 
significant bit of Bm. These instructions can be used^ for example, to 
identify a character address, 

^^^ction Description Notation 

2*10 If the least-significant bit in If "bm is odd, 
Bm is a one. place n in Ba ba' = n 

S"!"! If the least- significant bit in If bm is even, 

Bm is a zero, place n in Ba ba' = n 

Note particularly that it is the very least- significant bit that 
is tested, and that if Bm contains an address these instructions do not 
detect whether the address refers to an even or odd numbered vrord in the 
store, but rather whether it refers to an even or odd numbered character 
within the word. 

Examp le; 

B1 contains a character address, A.k say. Place this char- 
acter in digits 18 to 23 (character position 3) of B2 and clear the 
rest of B2 (digits to 17) 

E-ead the half-vrord into B2 

jump if k is .1 or .3 in the half-word 

sh±ft up and round six places 

shift' b1 down and round orae place, 
then subtract the original contents 
of B1 from this. This makes b1 even, 
if k is .0 or .S 

jimp if k =s -0 or «3 in half-word 

sliift up 12 bits, circularly. The 

required character is noy/ in c5 

of B2 

1*1 clear the unwanted digits 

A similar program to this is obeyed, under extracode control, when 
the profirammer specifies extracode 1250. 

1250 Ba Bm S 

places character s in Ba, clearing the other digits of Ba. So the ex- 
ample above would be simply achieved by 

1250 2 1 






101 


2 


1 





1 


210 


127 


1 


5 


2 


125 


2 








5 


163 


1 


i 






4 


211 


127 


1 


7 


5 


125 


2 








6 


125 


2 





Oi 


7 


127 


2 





7 
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4.10 Restrictions on the Use of B-registers 

-Although B81-B1i9 were included in section 4.1 as general purpose 
B-registers, they are of limited utility for the ordinaiy programmer, since 
they are each used by one or more of "bhe system routines which may assume 
control during the running of the object program* Before using ar^ of these 
B-registers, the B-test register, the substitution register, or the B-oarry 
digit, the programmer must check to see that there is no danger of their 
contents being overwritten before he has finished with them. 

The routines which use these B-registers are as follows:- 



B81-89 


Library routines 


B90 


Return link from library routines 


B91-97 


Extracodes 


B98-99 


The logical Accumulator and some '. 




extracodes 


B1 00-1 10 


Supervisor 


B111-118 


Interrupt routines 


B119 


Extraoode operand address 


B121, 122 


Extracodes, library routines 


Bt, Bo 


Extracodes, library 2X)utines 



It should be noted that the librar;/" routines may use extracodes. 
This means that when library programs are in use, no B-line above B80 
should be used (except for B90). Provided no reference is made to library 
routines, B81 - B90 may be freely used. Similarly B81 to B99, B119, B121, 
B122, Bt ard Be are safe to use when neither extracodes nor library rou- 
tines are in use. It is never safe for an ordinary program to use BlOO - 
B118, since an interrupt can occur at any time and cause control to be 
transferred to the Supervisor, 
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4,ii The B-carry digit 



any 


one 


of 


the 


four addition 


L codes 




104 








ba' 


==ba 


+ s 




114 








s' 


= ba 


+ s 




124 








ba' 


= ba 


■f n 




164 








ba' 


=^ba 


4- Cbm rSi 


n^ 



is \ised to add two 24-bit quantities, bit 25 of line 6 of the V- store is 
set to i if there is a "carry' from the addition. 

Thus for example the addition of any two 24-bit numbers v/hose left- 
most bit is a 1 sets the 'B-cairy digit' to one. If there is no 'carry', 
the B-carry digit is set to 0* i.Tien an ^iBL program is entered the B-carry 
digit is clear. 

The singly-modifed exfcracode 1225 loads Ba with n if the B-cariy 
digit is set to 1 and does nothing if it is not set. (The extracode does 
not affect the state of the B-carry digit, ) The following example uses 
1225 to add B1 to B2 and then add the 'canry', if any, to the bottom of B5, 
Thus the contents of B1 and B2 are here regarded as 24-bit positive integers 
whose double len^^th sum is placed in B5 and E2 with the most significant 
half in E5. 

iixample. 

124 2 1 
1225 5 3 II 

Similarly each of the ten instructions 

100 
110 
120 
150 
170 

set the B-cariy digit to 1 when, regarded as 24-bit positive integers, a 
larger number is subtracted from a smaller. Otherwise these codes set B- 
carry to zero. For example, the B-carry digit is set to 1 by the instruc- 
tion 172, 0, 0, i, 

■ Sxam gle: 

In the previous example bi was added to b2 and xhe double 
length sum held in B3 and B2. The follovfing two instructions 
would subtract b1 off again from the double length sum. 

122 2 1 
1223 3 3 -Y1 
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ba' 


= s - ba 


s' 


= s - ba 


ba' 


= n - ba 


bt' 


= s - ba 


bt' 


=: n - ba 



102 


ba' = ba - s 


112 


s' = ba - s 


122 


ba' = ba - n 


152 


bt' =ba - s 


172 


bt' =ba - n 



Chapter 5 

ROUTIHSS AND DIRECTIVES 

5.i Routinesj Subroutines and Symbolic Addresses 

Por convenience in writin^^i a large progran it is broken dovm into 
paxus, called routines. Each routine usually perforr.is sone particLOar step 
in the calculation, and the routines once decided on, nay be written in any 
order and then asserabled to^-ether to forn a prograja. 

Many routines, for example one which finds the cube-root of a nunber, 
are useful in assisting other routines. Such routines are called siibroutines. 
The prograLiaer may well write his subroutines before the major routines and 
have his own system of entry and exit from them so that more than one routine 
can call on a particular subroutine. Generally useful subroutines which have 
been written for use in any program form a "Library" of routines. 

In general subroutines nay be "open" or "closed". An open subroutine 
is simply a group of instructions which nay be inserted anywhere in a program, 
when they are required to be executed, control passes to the first instruc- 
tion; after the subroutine the next instruction after the group is obeyed. 
This has the disadvantage that the group of instructions has to be copied 
into the program vrherever it is to be used. 

A closed subroutine is one which is entered by jumping into an entry 
point, often the first instruction, and which ends by returning contirol to an 
address set by the program before entry. This exit address, called the "link" 
is normally by convention set in B90 for the Library routines,- these then end 
with the instruction 

121 127 90 Copy the return address set by the program 

in B90 into control. 

Particular examples of closed subroutines are the "extracodes" in 
Atlas. These are called automatic subroutines as entry to them is automatic 
on an extracode instruction being met. Exit from them is normally to the 
next program instruction, with no link needed. 

Within any routijie there may be many jump instructions. It is in- 
convenient to have to work out where each routine would be in the store so 
that the addresses for these instructions can be specified. Also, insertion 
of an extra instruction into a program xvritten with actual addresses might 
mean that many addresses had to be altered. Addresses are therefore allowed 
to be defined by m.eEns of parameters. Using these, any address can be re- 
ferred to in a "floating" form. Each tirie the prograra is read into the com- 
puter, the input routine assembles the true machine addresses and inserts 
these in place of the parameters. 

Besides the instructions themselves, certain additional information 
has to be provided with the program. This information is: 
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(a) liVhere the program is to be located in the store', 

(b) Which library routines are required. 

(o) The identification of routines, program titles, etc. 

(d) Yfhere control has to pass to in order to start obeying the 
program. 

This information is provided by means of directives. Except for (b) 
these do not produce any actual program within the computer. 

In general, directives are simply identifying letters (followed some- 
times by numbers) or equations which define the values of parameters* 

Instructions, floating-point numbers, half-word numbers, six-bit 
characters and directives will be collectively referred to as "items'*. A 
complete program can then be regarded as a list of items. 

Items are terminated by multiple- space, comma or New line. Depending 
on the input media, which may be 7-track or 5- track paper tape or punched 
cards, the programmer will use whichever terminator is most convenient. 

For simplicity we shall assume that the input medium is 7-track paper 
tape punched on a Flexowriter, and then state the alternatives for the other 
media. Multiple- space is defined as two or more consecutive spaces, which 
can also be achieved by using the character Tabulate on the Flexowriter. 

Routines are introduced by tho letter R followed by a routine number 
in the range i to 3999. They are terminated either by the directive Z, or 
by R followed by a new routine number, or by one of the directives virhich 
cause the program to be entered. Any program material not introduced by a 
routine number is automatically assigned to routine 0. 

A complete line of ABL input is read, and an image of the print-out 
is formed, taking correct account of the characters SPACE, BAClvSPACE, and 
TAB. TAB is interpreted assimiing 9 fixed TAB positions, at 8, 16, 24, 32, 
and then every 16 up to 112, character positions from the left-hand margin; 
TAB always moves the current 'carriage position' along at least two char- 
acter positions. A maximum of 128 character positions along the line is 
allov7ed for; any characters beyond position 127 are ignored. A backspace 
beyond the left-hand margin is ignored. 

In interpreting a line, ERASE, or a composite character incltjding 
ERASE, is everywhere ignored (except in circumstances where a direct copy of 
a string of oharactets is called for -see section 5.10 - C and CT directives 

- and section 6.13 - T directives, or with the SL record in library routines 

- see section 12. 7). 

The character small 1 is an illegal character. Otherwise ABL treats 
upper and lower case letters as being identical. The letters and I are 
treated as alternatives to zero and one. 
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5.2 Routine Parameters 

Within aEjy routine, up to four thousand parameters may be used 
numbered from to 3999. Parameters 1-5999 can be selh up by directive 
equations or by labelling items (other than directives), 

T/hen a parameter is set by an equation, or referred to generally 
it is preceded by the letter A» ' 

A1 = 100.4 sets parameter 1 of the current routine to the 
value 100.4 

When a parameter is set by labelling an item it is written before 
the item and separated from it by a right-hand bracket. 

1) 121 2 

The parameter then has a valxie equal to the address at which the item so 
labelled is finally placed. Hence, other instructions which refer to A1 are 
not affected by the insertion or removal of instructions in between them- 
selves and the labelled instruction. 

We have up to now always written the address part of an instruction 
as a number, either as a decimal number wLth an octal fraction or as a string 
of octal digits. In fact, the writing of an address may be done in a great 
many ways. In particular, parameters may be used to set up addresses, or 
parts of addresses. Thus 

''21 127 A1 causes a jimp to the location whose 

address is defined by A1 . 

Example : 

Routine 1 of a program is to clear store locations 512-1535 
to floating-point zero for working space and then exit to some as 
yet unknown address 

R1 

324 A1 set am' = 

"121 7 1023 set b7= 1535-512 

2) 356 7 512 store, modified 
203 127 7 A2 count, jump to A2 

"121 127 A3 exit to A3, not yet set 

1) ¥) 

Before the program could be run on the computer, A3 would have to be 
set. 

AO in each routine cannot be set by the prograzraner ; it is auto- 
matically set equal to the address of the first stored item of the routine 
(usually an instruction). AO can be abbreviated to A. 
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To permit cross references between routines, parameters are more 
generally referred to as ksa/n, meaning parameter m of routine n. If the 
/n is omitted the parameter is taken to belon^^ to the current routine. 



Sets parameter 3 of routine 
15 to J77 



iJxtract- half -word at Ai of R5 

If b10 = zero, jump to A2 of R5 

This instruction is labelled A1 
of R6, so that R6 may refer to 
it. 

An item may be labelled more than once. Thus 

i/6) 2/7) 5) 121 127 1 A4- sets A1 of R6, A2 of R7, and 

A3 of the current routine to 
the address of this instruction. 



Examples : 








1. A3/15 


= J77 






2, R5 








101 


10 





A1 


214 


127 


10 


A2 


1/6) 217 


127 


10 


A3 
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6«3 Preset Parameters 

These are Identified ty the letter P followed by the parameter 
number. One hundred preset parameters PO to P99 are available for nomal 
use, although certain parameters with numbers greater than this exist and 
have special effects, (see section 12,5) ' 

Unlike routine parameters, preset parameters are not associated 
with any particular routine, but are meant for use by the program as a whole. 

^ ^ .,„ „v.w v*u.xw*juj.j ijj GtiuttbJLUii, ana non oy xaoeixing; they may 

not be referred to before they have been set. Preset parameters are set 
immediately they are encountered, and hence everything; on the right hand 
side of the equation must itself already have a value. 

Preset parameters may be reset by further equations, and may also 
be unset, using the symbol U, followed by the parameter number. 

Ua will unset Pa 

Ua-b will unset Pa to Pb inclusive. 

Preset parameters may also be set and unset by program, using some 
of the special parameters listed in section 12.5. 
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5#4 G-lobal Parame ters 

These are identified by the letter G followed by the parameter 
nimber (0 to 3999). 

Like routine parameters, global parameters may be referred to be- 
fore they are set and cannot be unset. But, like preset parameters, they 
must always be set explicitly by means of an equation and not merely by 
labelling an item. 

Global parameters are not associated with any particular routine, 
and they therefore supplement preset parameters as universal parameters for 
use by all routines. 



( i.65 ) 



5.6/1 

^'^ Optioiml Parameter Setting 

Tills facility can best be described by means of an example i- 

•The library routine L100 uses a parameter, A24, to specify the max^ 
imum number of characters permissible on a line of input, which determines 
the amount of vrorking space needed to hold one line at a time. The pro- 
Crammer may arrange to set ;i2VLi00 outside this library routine, but if he 
neglects to do so then L100 will itself set A24 to the value 160. 

Such an optional setting is obtained by using the symbol ? before 
tne = sign in a parameter setting directive within the subroutine. This 
has the following effects :- 

(a) For preset parameters. The directive is ignored if the para- 
meter is already set, otherwise it is immediately implemented, 

(b) For routine parameters and global parameters. The directive is 
ignored if the parameter has been set by the time the next 
enter directive is encountered, otherr^ise it will be implemented 
at that time. 

The library routine L100 contains the directive 
i^4? = 1 60 

and if the programmer wishes for a different setting he must set A24/Liu0 
m his program. (see section 5,12.) 
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5.6 Expressions 



It is now necessary to explain the many ways In which addresses can 
be built up. 

The general form of an address is an "expression", and the Ba and Bm 
parts of an instruction, 6-bit characters and half-word numbers can also be 
formed from expressions. 

Basically an e3cpression consists of a mixture of parameters and con- 
stants which are combined together according to some relatively simple 
rules. 

We have written most constants as a decimal number with or without 
an octal fraction, that is as b or b.c, where b is the decimal number and c 
is the fraction, b goes into digits 0-20, o into 21-25. More generally, 
one can write a:b.c where b and c are as before and a is a decimal number 
?/hich is added into digits 0-11. The main use of a is to set up multiples 
of 512 in txhe ad.dress digits. 

iilternative forms are:- 
a:b.c 



t)«C 

b 

Examples ; 

1:35,6 is, in octel, 000-10455 
2: is 000200C0 

The symbol / may be used instead of :, as : does not occur in the 5-track 
paper tape or cejrd codes. 

The lettex- Y followed by a decimal number has the effect of posi- 
tioning the number from the least significant end of the register instead 
of one octal place up. Thus 

119 is 00000023 

as opposed to 19 T/hich is 00000230. 

We have also written numbers in octal, preceded by J or K. 

J followed by a string of up to eight octal digits assembles these 
from the most-significjmt octal position and right-hand zeros may be 
omitted. 

K followed by a string of up to seven octal digits assembles these 
from the right, starting at bit 20, and more- significant zeros can be o- 
ffiitted. writing .c after these numbers, vThere c is again an octal digit, 
places in digits 21-23. 
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lilxamples : 

1. J04iG3 is 04105000 

2, K37 is 00000370 
S. K31,5 is 00000&15 

It is also possible to forru a number by writing a constant n-n ■ngr'^. 
aeter which is followed djsmediately by one or more of five "operators". 
These operators allow numbers to be shifted up or do;vn logically, allow 
the extraction of the 'block address' digits or 'address within a block' 
digits, or form the logical binary complement of a number, 

We shall use the term "element" to mean either a constant or a 
parameter, or one of these followed by one or more operators. 

The operators are as follows:- 

(a) Dn where n is a decimal integer. This causes the previous element to 
be shifted dovm logically by n places, i.e., shifted down without ducli- 
oation of the sign digit, e.g. ^ 

121 121 100D1 

is an alternative to writing 

121 121 60 

and sets bl2l pointing at B100, for use in conjunction with bl22. 

(b) Un causes the previous element to be shifted up logically by n binarv 
places (i.e. multiplied by 2 ). e.g. 

121 124 13U12 

sets the exponent digits 0-8 as +13, (This is more convenient than having 
to work out the number in ootal in the appropriate place. ) 

(o) B gives the block address, i.e. bits 0-11, of the previous element. 

vr±th- bits- i2:.^25"'maffiD aei?¥r^ ' " " " " ""^ " '" "" " 

(d) W gives the address witliin a block, i.e. bits 12-23, of the previous 
element, with bits 0-11 made ssero. 

(e) (prime) gives the logical binary complement of the preceding 
element, e.g. 

1 21 2 J1 ' 
sets b2 =: J67777777 

The use of ' is not encouraged, because it is a symbol so easi3;jr 
overlooked in a program print-out. 
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5,7 Separators 



laements can be combined together in m&ny different ways to form 
a final expression, 

(i) Elements may be added or subtracted. 

Thus 3 + Ai , A1 - 5, A1 + A2 - A3 + 6Di for example, are all 
allowed. Where the next element is to be added, the + may be omitted if 
there is nc possible ambiguity. Thus, equivalent forms of the three ex- 
amples above are 3A1, -3Ai, A1A2 - A3 + 6Di. In the last case, the final 
+ cannot be left out as this would form -A36Di , 

Examples ; 

^24 SA-l Sets am' =s contents of the third 

location after the address given 
by Ai. 

121 127 -2A16/3 Causes a jump to the instructdbon 

two before the address given 
byAl6/3, 

(ii) The logical operations AM), non-equivalence, and OR can be 
performed between two elements. The symbols for these are &, N and V 
recpectively. M is an alternative to &, 

Example ; 

K77.7&A2 Extracts the least- significant 9 bits of A2 and 
sets the other digits to ^e]?o. 

(iii) Elements may be multiplied ajid divided. The symbols used 
are X and Q. 

Examples ; 

A1 X 30 Multiplies A1 by 30 
A1 Q 30 Divides A1 by 50 

For these two operations, elements are regarded as 21 -bit integers with 
octal fractions. After multiplication, the answer is made a 21 -bit in- 
teger with an octal fraction; the result is taken modulo 2^° and the 
octal fraction is rounded away from zero. After division the result is 
an integer in digits 0-20, rounded towards zero, and is always exact if 
an exact result should be obtained. 

Examples ; 

2.4 X 2,4= 6.2 Exact 

2.1 X 1,2 = 2.6 Result rounds may from zero 

J001 X J001 = 2^^ = 0, modulo 2^° 

Y1 X Y1 = 0,1 Result rounds away from zero 
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17 Q 3 =3 5 Result rounds down 
14 Q Ss4= 4 Ssact 

The sjinbols ^ -, &, U, N, V, X, Q are termed "separators". 

An expression consists of a string of elements and separators, and 
oils elements are evaluated and compounded together from left to right. 

Elements and separators are allowed to be enclosed in round bra- 
ckets, and sets of brackets within brackets are permitted. The contents 
wt crackets, beginning at the deepest level, are evaluated first and re- 
plaoed by single elements before the general left to right evaluation is 

carried out. 

+ and - signs may also precede any element, including the first 
of an expression, or follow any separator other than themselves^ 
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5.8 The Special Parameter ♦ 



When * is set by an equation such as * = expresBlon, it is dLnter- 
preted as a directive determining where succeeding items are to be placed 
in the store. 

For example 

* =. 100 

1 21 1 6 

224 1 A2 

• • • t 

arranges that the first instruction is placed in location 100, the next in 
101, and so on until a further setting of * is made. If * is not set at 
the head of an ABL program, * = 1: is assumed. 

The right-hand side of the * directive must not contain any para- 
meters irtiich have not been previously set. 

Optional setting of *, that is *? == eaqpression, is not allowed. 

^ When * occurs in an expression on the right-hand side of a directive, 
then is equal to the address of the next available character position, ex>- 
cept when it is set to the address of the next full-word or half-word by the 
directives P or H respectively. (See sections 5.10 and 5.11) 

When * appears in any item other than a directive, it has the value 
of the store address of the item. 

The instruction 121 127 * is a loop stop as * equals 
the address ?diere this instruction is held. 

121 127 S* causes a jump round the next 2 

instructions. 

may be used in expressions as an ordinary parameter. Insertion 
of extra instructions into a program is more liable to lead to errors if * 
has been widely used. In the example above, inserting another instruction 
to be jumped round would also involve altering the jump instructions to 

121 127 4-* 

There are no applications in expressions for * tl^^.t cannot be achieved by 
the use of ordinary parameters. 
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5«9 The Ba and Bm Parts of on Inatniotion 

An instruotion is regarded as an item, although the four parts of 
an instruction have to be separated by multiple spaces or commas, and no 
other items may occur on the same line» 

The Ba and Bm parts of an instruction have been written so far as 
integers in the ranee 0-127- Jxi fact tViRv nnr^ -he wr.^++«r. «« r.-«^.«««e-;«-- 
like the address part. Bits 14-20 only of the expression are extracted 
and placed in the Ba or Bm position. 

One use of this is in relativisation of B-register addresses. For 
example, a routine might require the use of some B-registers without it 
bein^ known at the tine of writing which would be most convenient. By 
writing the B-addresses relative to a parameter the range can be decided 
later and the parameter then set. 



Examples 








R9S 








165 


A7 


1A7 


0.7 


165 


2k7 


1A7 


J4 


214 


127 


A7 


A1 


101 


3A7 


1A7 






If it is decided" that B62 onwards can be used for this routine 
then the directive A7/9S = 62 will set the B-registers referred to as A7, 
1A7, 2A7, to the values 62, 65, 64, 
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5«''0 HslP-Words, Si3c-Bit Wei^a and Glaayft Otcra 

The directive H introduces 24-'bit numbers. These numbers are 
written as expressions in exactly the same way as in the address parts of 
an instruction. 

After H, successive expressions on one line are regarded as 24-bii- 
items and placed in the next available half-v/ords« The letter H, which iieeda 
no terminator, need only appear before the first expression on each linos 

Examples ; 

Hi 2 3 4 

HA5/2 A6/2 5.6 A7/2 & K77 

Any of the items can be labelled in the normal manner. If the item to be 
labelled is one with the directive H, the label can occur before or after 
the H. 

Example s i 

3)H 1.4 2.4 4)3.4 
H 5)A1 

Other directives may occur mixted with half-words. 

Example ; 

H6 7 A1=* 8 9 Aa=57 

The directive H also increases ", if necessary, to the address of 
a half-word. 

The directive S introduces 6-bit words. Its action is almost 
identical with that of H, except that only bits 15-20 of expressions are 
used and these are assembled into successive character positions. 

Example : 

SI 22 3 1)4 

On one line it is possible to write some half-words, and some six- 
bit words. Thus 

HI 3)15 2064 S3 15 Al H96 97 

is permitted, for example, each directive stating the interpretation to be 
given to succeeding numbers up to a nev; directive or nev/-line. 

The numbers would appear in three successive words of the store as:- 



OOOOQO 000000 000000 001000 I 000000 00000 000001 111000 I 



m R15 
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000000 000100 000010 000000 



X 



000011 



001111 \xsoaoac 



irr: 



Tm 



H2064r 



S3 



S15 



SAI 



000000 000000 001100 000000 



Tz: 



000000 000000 001100 001000 



zur 



im- 



H97 



However, for olaritjr, ,the mixing of numbers in this way is not to "be en- 
couraged. 

Several directives are provided to read in characters from the in- 
put media and to store them in internal code ready for output. The string 
of characters is introduced by one of the following C directives. All sub- 
sequent characters after tho directive, up to and including newline, are 
ignored, and all the following characters in the next record except the 
carriage control character are stored. The line is not reconstructed, 
characters being stored as they are punched, apart from shift changes. This 
means that redundant shifts (e.g. run-out on 5 a:id 7 track tape) are stored. 

G The characters a-re stored in the next available character locations. 
P 123 gives the number of characters stored plus J4« 

Ca As for C, except a is placed in the next character location after the 
string, to be used as a carriage control character (where a is an 
octal number less than 77; a point betvv-een the digits will be ignored). 
P 123 gives the number of characters stored (including a). 

The first character may be labelled by inrriting a label before the C or Ca. 

CT The next available halfword is set to the number of characters plus 
J4 and the characters are stored in the following character locations. 

GTa As for CT except that a is placed in the next character location after 
the string, to be used as a carriage control character, and the first 
half-word is set to the number of characters. 

The half-word containing the character count may be labelled by 
writing a label before the CT or CTa. 

- An additional C added to the directives C and CT making CC and CCT 
(orCTC) respectively, has the effect of ensuring that the string of charac- 
ters ends in inner set, adding a 'shift to inner set' character if necessary. 
This extra character, if required, is inolijded in the count of characters. 
An additional C added to the directives Ca and CTa will be ignored. The use 
of the additional C is intended for continuation of the record with f iirther 
output which will start in inner set. 

In every case, the character count is positioned from the least 
significant end of the register. 
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CS is intended for a list of te:cbs any of which can be output by 
the instructions 

10i 2 -I 

1066 2 1 Y4 

where Bi contains the address of the label attached to the CT directive, 
A description of the output procedures is given in Chapter 8# 

For example 
1)C 
No solution 
A2 = -0.1* A4 = (A1 - A2)U3 + 1 

assembles the comiaent 'No Solution' as internal code characters, sets A1 
equal to the address of the first character, A2 to that of the last and A^ 
to the number of characters. 
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^ 48-bit floating-point numbers ma;yr be r-Titten in various tojtb. Each 
r.ur.cer xs assembled into the next full-word location. The ways in which 
sucn numbers may be written are listed below. 

The follov/ing notation is used:- 

a is a sicned decimal number, ivhich may include a decimal Doint 
with any number of digits before or after it, ^ " ^"^ y^-^-*' 

b, c, d are decimal integers which may be preceded by a sign 
(optional if 4.^, 

In the following cases the exact or nearest possible value is 
assembled as & standardised floating-point number, 

(i) a 

Examples : 
■ifl 
-16354,77625 



-27 
(ii) £.(t) The value of the number is a x 10^ 

Examples: 

+5(^2} 
-.5(^7) 

(■^^y H Vl> ^.J^^® °^ the number is a x 8° 
...xamples : 

-17(t-2) 

(iv) d(I;ic} Ii.: /.ilue of the number is a x 10^ x S' 










^-+ 4.x, ''^'^".^''^ ^^ ^^^^ ^-^' «'-ys listed aocve :d .us^- be va-itten. TLcn, 
4tcr the staruaai-aisea numcer has been formed it will have its exponent 
w.w-ed equal to a with the mantissa shifted aocordingOy. Thus a:d, a(b):d, 
< .o):d and a(b:c):d are the four ways of writinc floating-point numbers 
With forced exponents. 

It is also possible to vnrite o^/ of a, b, c or d as octal numbers. 



( 1,65 ) 



5,11/a 

a oen be written as a string to any length of octal digits which 
may include an octal point, and these must be preceded by + or -, and the 
letter YU 

e.g« ^K563.i74 

-K.265 

-K777777 

b-, or d canb e written as an octal integer preceded by K. The K 
may be preceded by a sign. 

e.g. Ki4 -K276 

The character / can be used as an alternative to :• 

Note: If the program contains a floating-point number that 
is too large to be stored in Atleis standardised form the 
pi*ogram will be monitored during compilation and thef ault 
indicated by the monitor printing E}!POKENT OVERPLOW. If a 
floating-point number is too small to be represented in 
standardised form iiBL will store f loating-point zero in 
its place and continue compiling the program. 

If the exponent of a floating-point number is forced 
to a value that is too small to allow the number to be 
represented in standardised form, the program is monitored 
and AO on fixing is printed to identify the fault. For 
example, +i:0 requests that 1 be stored in floating-point 
form v/ith exponent zero, which cannot be done (-1:0 would 
be acceptable). 

Any floating-point number can be labelled, ard more than one may 
appear on a line. Floating-point numbers can also be mixed with half- 
words and six-bit woards on a line, provided that the first of a group on a 
line is preceded by the directive F. 

This directive, which does not need a terminator, introduces floa- 
ting-point nimbers. It has also the effect of increasing the value of *, 
if necessary, to the address of a full-word, and it can be used, for example, 
irsmediately before H to ensure that the next half-word is stored as the more- 
significant half of a full -word. 

Example ; 

H24 F R25 S6 12 F S4 H S61 P+127 



would appear in four consecutive words of the store as 



000000 000000 000011 000000 

r~ ". ' ' " ". ' ' ' """" '^ — "". ' ' ' " "T" 

I III I H I I »■ «i I «■ i..i . ii.« »■ ■ • — 1 . 11,.^ ■■■ V 



] 



H 24 
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I I ■ 

I 000000 000000 000011 001000 I 000110 001100 



H25 



S6 12 



000100 



1-11101 



n I 



S4 



S61 



i 1 1 

|0j 0000011 001 111111 000000 000000 000000 000000 000000 

P+127 

The practice of mixing the different types of number on one line is not 
encouraged. 
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6,12 Library Routines 

A copy of the standard libraiy routines is held on a system magnetic 
tape* 

To avoid confusion with programmer's routines, library routines are 
referred to by the letter L followed by a decimal number in the range 
1 - 1999. 

Parameters in library routines are referred to by elements of the form 
Aa/Lo label a of libiTary routine d. 

Some libraiy routines may have more than one routine. In such cases, 
the routine number is written before L, 

Aa/bLo label of a routine b of librarj^ routine o# 

In some programs, it is oooasionally convenient to have more than 
one copy of a particular library routine-* To allow references to a^y 
particular copy, it is identified as Lotd, copy d of Lo» Copies 1 - 1999 
are permitted- 

Aa/bLc#d label a of routine b of library r out ine o, copy d. 

It is possible to refer to library routines in the address parts of 
instructions or in expressions for half-words etc. without calling for them 
explicitly by an L directive. If this is done, when the directive E or ER 
is reached, any such library r outines are found and read into the following 
storage locations. 

If it is desired to insert a libraiy routine at a particular address, 
this may be done by setting the address with a * directive, if necessary, 
and then writing an L directive, for example :- 

* = A2 ^ 

•) read L10 into addresses from A2 onwaMs. 
L10 ) 

If all libraiiy routines mentioned earlier in the program are to be 
inserted, then no number follows L, for example:- 

L read all library routines previously mentioned into the current 
address onwards. 

In this case, the action is just the same as when an E or SB. direc- 
tive is encountered, except that the L directive may be placed anywhere in 
the program after the library routines have been mentioned. 

Private library routines may be inoorporated into a program; this 
is described in Section 12,7, 



( 1,65 ) 



s.i:V^ 



5.13 Directives 



Most of the directiYes have been introduced in this chapter, Qhis 
section gives a complete list of the directives and describes those not so 
far introduced. 

Equation directives are used for setting the values of routine 
parameters (t-S999 per routine), of *, of global parameters (0-5999), and 
01 preset parameters (0-S9)« They are of the form 

Parameter = Expression 

Optional parameter setting (except for *) is of the form 

Parameter ? = Expression. 

Any optional parameter settings to be made for a library routine should occur 
before the L directive that calls that routine. 

* Ignore ^ directives 

(i) vertical line | which does not need a terminator has the effect 
that all subsequent characters up to the next new-line are ignored. This 
allows comments and notes to be inserted into a pi^ogram for the convenience 
of anyone reading the program print-out. The characters w and £ are alter- 
natives to 1. 

(ii) Square brackets £ 2 which again do not need terminators 
have the effect that anjrthing contained within them is ignored; the sections 
to be ignored may stretch over any number of lines and part lines. This 
facility is intended for lengthy comments or the temporary ignoring of whole 
sections of program, for example during the development stage of a program. 

< and > are alternatives to [" ], but < and > can be used with 

their meftninP'R nf "l^ec +:Vinr>" a-nri "cn-^.o+o-r. 4-Vir.v.M T.r^4-V-?.« c,,-,,^-,^^ -S^-^^^t^^J.^ TX> 

< is encountered first then [^ and J can be freely used within the comments 

Both I]" 2 a»i < > oexi be "nested? \7hen |J is encountered what fol- 
lows is scaimed with: only |and^^J reco^gnlsed, A ^ount starts at 1 on 
the first [], is liwroased by 1 for each further [" and reduced by 1 for each 1. 
The comment is considered to have terminated only vfhen this count becomes 
zero. < and > are trt;ated in exactly the same way. 

(iii) Query ? followed by an expression and a terminator, has the 
effect of ignoring the rest of the line or not, depending on the valiie of 
the expression. If this is zero, the remainder of the line is ignored as 
with I ; otherwise, there is no effect. The expression must already have 

been assigned a value. 

ExaniLLest 

&>b] 

<1+ap+bP+o[;i ... > 
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?P50 I 

• .•XX 13 

This last causes the following lines up to l to be ignored 
if P50 is non-zero, but to be taken aocoimt of £p P60 ia zero* 
The I before J ensures that the J is never unmatched. 

Note: I fr£ [^< and ? are directives and not terminators'. They must not 
ocour other than after cforreotly terminated items. 

C and CT directives 

The directives C and CT on one line introduce 6-bit characters on 
the followiftg line, (see section 5,i0) 

E directives 



a 



The enter directive, S followed by an expression:. The expression 
gives the address at v«-hich the program is to be started when it comes to be 
executed. • The directive has the follovTing effeot*:- 
It teiminates the current routine. 

All parameters and expressions which have been used are evalu- 
ated and inserted into the program^ 

(c) Library routines are found and inserted at ihe required places 
or at the end of the program, deperiding on whether they were 
called for by L directives or simpl^^ referred to. 

Library routines that have been refeiTed to in the program 
(but not explicitly called by L-directives ) will be inserted 
in store locations immediately after the last item before the 
E directive. Note that if * directives have been used this 
is not necessarily the highest address used by the program, 
and care is required to ensure that library routines do not 
overwrite any part of the program. The library routines may 
be stored in, for example, locations A3 + 9 onwards by preceding 
the E directive by * = A3 +9. 

(d) Fault indications are printed out for parameters which are 
used but not set, and for any other faults encoiintered. If 
there are axiy faults, the program is normally suspended and not 
entered, (see section 12.6 for exceptions to this.) 

(e) The compiler, which has occupied store locations above | x 2^° 
(that is, J3) is deleted from the store so that storage location 
nimbers up to | x 2^° (that is, J34) may now be used. (Note: 
the Supervisor uses store locations from J34 upwards). 

There are also two other enter directives which may be used. These are;- 

(a) ER followed by an expression. The effect of iilR is the same as 
E except for part (e). That is, the compiler and parameter 
lists are retained in the store. The program can then only 
use storage locations up to J3, 

(b) EX followed by an expression. This is the enter interliaie 
directive. All parameters Y/hich have been set and all expre- 
ssions which oan be evaluated are inserted into the program. 
The program is then entered at the specified location irres- 
pective of unset parameters, and without the insertion of 
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library routines other than those called for by an L directive. 
The EX directive doea not terminate a routine. 

Bi to B88 are cleared before a program is entered by E, ER or EX. 
B89, however, contains the cuirent value of *. After an E directive B90 
contains J3; after ~M and SX B90 is clear. 

Any enter directive may be labelled, and the specified parameter, 

which is taken to "h^lf^rn? +n +1^^ YVMi+-ir»ft +:c»»r,-?«e4-ja/:j -U,, 4.V^ J jj j.j — 

is set to the current value of *. In the case of E and ER this setting is 
made after any necessary libraiy routines have been inserted, so the label 
always refers to the address of the first available character location after 
the program. 

F directive 

F introduces a group of floating-point numbers (on the same line) 
and can also be used to increase the value of *, if necessary, to a full- 
word address. 

H directive 

H introduces half-word numbers (interpreted as 21 -bit integers plus 
a single digit octal fraction) and also has the effect of increasing the 
valiie of , ;There necessary, to a half-word address. 

L. Library directives 

Lc.d, where o and d aro decimal nianbers in the range 1-1999, calls 
for copy d of libraiy routine o to be inserted at the progrcjn location in- 
dicated. 

L, when followed by a terminator but no number, calls for a copy of 
all library routines mentioned earlier in the program, tc he iasrerted .at the 
program location indicated, 

R. Routine directives 

Rn, where n is a decimal integer in the nange 1-3999, defines the 
start of a new routine. 

S directive 

The direotive S precedes a groiQ) of 6-bit integers which will be 
stored in successive character positions. 

T. Title directive 

After reading T followed by new-line, the ne2± line of characters 
is copied to the program output channel 0. The title directive can also be 
written as Ta or Ta-b where a and b are decimal integers. In the first 
case the next line will be copied to the program output channel a, in the 
second to channels a to b inclusive. 

If desired the T, Ta or Ta-b may be terminated by comma or mxaltiple 
space: the remainder of that line will then be ignored and again the next 
line will be treated as the title and copied to the output. 
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As with C directives, there is no line reconstruction of the text. 
U. Unset Parameters directive 

Tfe, where n is a decimal integer, causes the preset parameter Ptt 
to be unset. Further, Un-m unsets from Pn to Pm inclusive* 

Z« End routine directive 

Z indicates the end of a routine. UsToaOay ^s is »»* »^°"«"y' 
,i„oe a J. E directive implies the er& of the precimg ^Y*^!^ o 
p"^a^ material hetween Z aM the nert R wUl te assigned to routim 0. 
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Chapter 6 

TH5 R^AAJMNQ- ACCUMUL.vrOR INSTRUCTIONS 



^In Chapter 3 we desorihed the accumulator ejid some of the basic 
accuuTi 'ij L M ■■OT'/ instnictioK" * 

All the accumulator instructions operate on floating-point numbers. 
The:;' aay be divided into groups as follows :- 

(a.) Standardised rounded operations 

(b) Standardised unrounded operations 

(c) Unstandardised operations 

(d) Test instructions. 

The only standardised rounded instruction not so far introduced is 

360 Standardise a, round am am' = a QBE 
and checlc for exponent 
overflow 

6.1 Standardised Unrounded Operations 

In these instructions, L is cleared before the operation, and after 
the operation the result is standardised as a double-length number in A. 
An interrupt occurs if the exponent overflows. 

300 Add am and s a' =r am + s QE 

501 Subtract s from am a' = am - s QE 
302 Negate am and add s a' = -am + s QE 

The instructions are thus similar to 320-322 except that rounding does not 
occur. ^ 

The following instructions are lilce 300 and 301 except that L and 
Ls are not cleared initially. 

They provide a limited form of double-length working; limited because 
the answer is on3y correct if ay < sy (i.e. the exponent of s must not bo 
less than the accumulator exponent) 

310 Md s to a a' = a + s QS 
(pseudo double-length) (if ay < sjy) 

311 Subtract s from a a' = a - s QE 
(pseudo double-length) (if ay < ay) 

Before two numbers are added or subtracted in the accumulator, the 
one with the smaller exponent is shifted down into L and its exponent in^ 
creased accordingly until the two exponents are the same. 



( 1.65 ) 



6.1/2 



In the S10 end 311 instructions, if ay ^^ sy then e^x is shifted down 
correctly. If sy < ay then sx \Till be shifted down into L, and the origi- 
nal contents of L will be spoiled. In this case the definitions of 310 and 
311 vrill be 

310 am' = am + s, i spoiled. QE 

311 am' =: am - s, 1 spoiled. QE 

Extracodes are provided for correct double-length working in all 
cases and these are described later. 

Two store locations are needed to hold a double-length number and 
it is conventional to store both numbers as standardised numbers with the 
less-significant half alvrays positive and with an exponent which is at 
least 13 less than that of the more-significant number. 

The contents of the accumulator are 

am + al.er=^® 

as the floating point number al has an exponent ay which is 13 more than 
its true value. 

j.x±e v^^j insurucui-on xs pr-ovided to position a 1 correctly. 

355 Copy the special sign bit of L a' = aO^S"^^ Q 
(Is) into all bits of M, then , 
standardise a = a - am Q 

when Is = 

Example t 

To store the accumulator contents for double-length working in 
locations 100 and 101 

356 100 store am 

355 J4 position ai * 

356 101 store al.r^^ (Q) 

Note: All accumulator instructions make a reference to the store 
and obtain a store operand, even if the function does not 
use it. Any store address within the program is of course 
allowed, but as operands are read from the fijced-store very 
much faster than from the core- store it is conventional to 
specify the first address in the fixed- store, J4, in such 
instructions. 



Locations 100 and 101 contain t\7o numbers to be regarded as a 
double-length number. Add this number into the accumulator, using 
locations 98 and 09 as working space. 

356 98 store am 
355 J4r position ai 

320 101 add less- significant halves, 

QUE, in am. 
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store partial answer 

replace original am 

add most- significant halves, 
result is standardised but 
not rounded in a 

356 98 store most- significant part 



356 








99 


524 








98 


300 








100 



355 








J4 


position the rest 


300 








99 


add in less- significant sum 


310 








98 


final ansvfer in a 



(This program is extiracode 1500) 

The following instructions complete the stajidardised unrounded 
operations 

340 Standardise a, check for a' == a QE 
e3q)onent overflow 

542 Multiply am by s, leaving the a' = am»s QS 
double-length product 
standardised in a 

343 As 342 but multiply negs^tively a' =s -am.s QE 

366 Clear L, complement am if a' = |Qffl| QE 
negative, and standardise 

367 Clear L, copy the modulus of a' = |s| QE 
s to j\m, and standardise 
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6#2 Unstandardised Instruotiona 

The xmstandardised instructions can be divided into foxir groups 

(a) Those concerned with storing and loading the acoum^LLato^• 

(b) Multiplications. 

(c) Divisions. 

(d) Miscellaneous. 

6,2.'! The imstandardised instruction which store and load a are described 
below: - 



s' =: am 



356 Copy am into S 

357 Copy al (that is 1, as and ay) 

into S s' = al 

346 Transfer am to S and clear A s' =: am, a* = 
(a' = floating-point zero) 

347 Transfer al to S and clear L s' = ai, i' = 
and Ls 

S into L and Ls, leaving M, 
including t-.-.3 exponent, 
imchanged 

346 Copy the argument from S into L l' = saj, m' = sign 
and the sign bit from S into Ls of s, ay' = ay 
and all bits of M. Leave the 
exponents unchanged. 



314 



Copy s into Am leaving L and Ls am' = s, l' =s 1 
unchanged 



315 Copy s negatively into Am am' = -s, l'=lAD 
leaving L and Ls unchanged • 
(AO will be set for s =: -1.0) 

6.2.2 Unstandardised Multiplication Instruction©. 

"" ' *■ " "" ■!■ i lt iil m I ■■ I 1. ■■ I. ..Ill — 

372 Multiply am by s and leave the a' = am.s 
double- length product unstand- 
ardised in A. Clear the sign Is' = SAO 
bit of L. Check for exponent 

overflow and aooumulator over- 
flow 

373 jIs 372 but multiply negatively a' = -am.s 

Is' = EAO 

352 Multiply am by s, leaving the a' =» am.s 
double-length product unstand- 
ardised in A, and set the sijgn Is' = sign of m EAO 
bit of L equal to the sign of 
the product. Check f or E and 
AO 

363 As 352 but multiply negatively a' = ^ wh.b 

Is' = sign of m EAO 
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352 and 353 are identical to 372 and 375 except that they set Ls 
instead of clearing it« These instructions (552 and 353) are intended to 

f ora the single«length product of two unstaiidardised integers and leave the 
mantissa in L with the correct sign in Ls; the^' can therefore be redefined 
as 

552 l'=ni.saj S 

353 l' = -m.sa: E 

Note, however, that the exponent ay' will be applicable to the double-length 
product in A, and that the accumulator overflow v;ill not be set 'when the pro- 
duct overflows into M, but only when the double-length product overflows, 

6, 2, 3 The Division with Remainder Instructions . 

'^here are tliree division instructions which give the quotient in L 
and the remainder in M, However, these instructions only operate coivrectly 
for numbers which ohey certain conditions. 

There is a large range of division and remainder extracodes provided, 
which use these instructions and ensiire the required conditions are fulfilled. 
For most purposes, it is easier to use these e^ctracodes rather than the basic 
instructions. The only exception to this rule is the use of the 375 instruc- 
tion for division of positive fixed-point integers, and this special case 
will therefore be described first:- 

A fixed-point integer c can be represented in a 48-bit word by a 
fractional mantissa so3= c x 8"- , where n is normally "12 or 13, ajid an ex- 
ponent sy, usLiall;^'' + or + r.. Provided that they are positive and that the 
divisor has sa; < z, which even with n = 12 allows integers up to 30,000 
million, the 375 instruction can be used to divide one such number into 
another. The dividend should fnj:'st be placed in L, with M clear: this places 
the dividend in Ax with an additional scale factor of ^^ ' and ensures 
ax < iSici provided that Bxf= 0, The simplest case of the 375 instruction may 
now be defined as follows :- 

375 Fixed-Point Integer Division 

Divide a by the modulus of b, l' = a/|sl E 

placing the quotient in L and m' = remainder 

the remainder in M, a end s (0 < a^j < |sa;| < i") 

must satisfy < aa; < |sa;| < -g-; < m' < |sa;| 

the remainder will then lie ay' = ay - Sy 
in the range < m' < |saj|. 

After obeying the 375 instruction the remainder m' will be scaled by 
the seme factor as the dividend, and it shoiad therefore be assigned the same 
exponent. The quotient l' will be an lateger soalad down by 0*^^ and it must 
be shifted up one octal place if it is required to store it with a scale 
factor of a-^ = . 
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Example: 

G-iven two fixed-point integers o and d in A5 and 1A5, 
eaoh stored with one octal digit after the point; e.g. o is 
stored vd.th mantissa 8"^° o in A 5, Form the quotient ajod 
remainder of c/d, in the same form and with exponent 12, and 
store them in locations 7 and 8. 

ax' « ^^^ (er" c) 

(i.s^, m' = and r = 8"=^' o) 

$: = 8r^^ c/d 

m' rs-^^^ X remainder 

ay' =12 

Remainder am to location 8 

1' = &- "-^ o/d 

Qiiotient al to location 7 

The full definition of the 375 instruction is as follows: 

375 Pseudo Fixed-Point Division 

lyxvjoxc a uy i/iio mc>u.uj.uib ux a^ sax = a/ is jci 

placing the quotient in Al m' = "renainder" 

and a form of "remainder", (0 < Slx < \sx\ < 1) 

m', in M. If m' > the Troe remainder 

true remainder m" = m', but Ih" == m' if m' > 

if m' < 0, which vrdll only a. m' + 1,0 if m' < 

occur when m" > -g, then ^ m* < jaaj| 
m" = m' + 1.0 " 

a cjxL s need not be standardised but they must satisfy the res*- 
triction ^ aa; < \sx\ < 1»0. The true remainder m " vdll then satisfy the 
constraint ^ m* < |sa;|. aj/ is the exponent of the quotient. The ex- 
ponent of the remainder is ay - 13, i.e. 13 less than that of the double- 
length dividend a before the operation. 

If sa? < aa; < 8 lsa?| or If sa;= -1«0 the 376 instruction provides a 
quotient and remainder m* 7/hich are correct if regarded as floating-point 
numbers but which break the rules of fixed-point division. The remainder 
may be larger or smaller than with true fixed-point division, its exponent 
being as follovirs: 

Condition Ebcponent of Remainder 

|sa?| < aa; < 8 |sa?| ay - 12 

<-aaj < |sa;| < 1.0 ay - 13 

sa:=^ -1«0 and aa? > ^ ay - 13 

saj= -1.0 and ^x <\ ay - 14 

When \sx\ < aa? the adjusted remainder m" ma;^^ iKst be exact, because the last 
octal digit of the correct remainder will have been lost. 
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3f act; < then am v/ill "be negated before the division takes place 
but 1 wiU not be adjusted. 

If a > 1.0 then ax vd-11 be shifted down and its exponent increased 
by one before the operation. 

If 833=: or aa; > 8 \sx\, the 375 instmction will not give a correct 
quotient or remainder. 

576 Divide a by the modiilus of s, 
placing the qw.-tient in Al and 
the "remaind-^i:-" in M. The 
divide^id a must not be negative 
and the divisor s must be 
standai'dised before the 376 
instructed is obeyed. The 
"remainder" is such that? 
mantissa of true remainder = m if m > 

= m + l.o" if.m < 
exponent of true remainder = ay - 13 if jaa?| < jsa?| 

= ay - 12 if |aa;| > \sx\ 

The quotient al' is not normally an integer; it is merely the un- 
rounded representation of a/s to such accuracy as is possible in the 39 
bina3?3'' digits of L, The true remainder has no special significance other 
than that it represents a - s.al' and is alwaj^'s positive or zero. When 
\six\ > \5x\ the true remainder m" may not be exact, because the last octal 
digit of a - s.al' will have been lost, 

E3q)onent overflow is checked for, and division overflow occurs if s 
is unstandardised or zero. If a is in standardised foiro before the division, 
al' will be a standardised quotient, but m' and m" may not be standardised. 

o/ / LIJ.VJ.U.C wic iiiuuujLus uA ciiii uy wie a J. = tun j / jsj ruju 

modulus of s, placing the quotient Remainder 
in Al and the "remainder"^ as m* == m' if m' > 
defined for 376, in M. Check for = m' + 1.0 if m' < 
E and DO. The divisor b must be 
standardised. 32* am is in 
standardised form before the 
division, al' will be a stand- 
ardised quotient, but m' and m" 
may not be standardised, 

6,2.4- Miscellaneous Unstandardised Instructions 

354 Round by adding. Add one to the am' = a.R+ AO 
least- significant digit of m if 
the most-significant digit of 1 ig 
a one. Accumulator overflow can 
occur. The contents of L are 
unchanged. 

54A Check for exponent overflow, a' = a E 
a is unchanged. 

361 Round am and check for exponent am' = a RE 
overflow, 
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6.5 Test Instructions 

The following four instructions are tests on the accumulator man- 
tissa, and comparable to the tests on bt or bm. Note that bm can be used 
to modify the address, 

234 Place n in Ba if the accumulator ba' = n if aa?= 
contains zero. 

235 Place n in Ba if the accumulator ba' = n if axi^ 
does not contain zero. 

236 Place n in Ba if the accumulator ba' = n if aa? > 
contents are greater than or 

equal to zero. 

237 Place n in Ba if the accumulator ba' = n if aa; < 
contents are less than zero. 

All these test ignore the sign bit of L. 

Tor the accumulator to contain zero, both guard bits must be zero; 
the most- significant guard bit, rather than the sign bit, detezrmines whether 
the accumulator is greater or less zero. With standardised nunbers this is 
immaterial, as the guard digits vidll be copies if the sign bit, and with 
fixed point working the correct result might still be obtained even if 
accumulator overflov/ had oocured. 

Examples ; 

1 • Increase b3 by 0, i or 2 depending on whether am is >, = or < 
the contents of store location 16. Let AiO be the address of a 
register available for vrorking spaoe. 

356 A10 store am 
321 16 an-s 

234 3 3 1 b3' = b3 + 1 if an = s 

237 3 3 2 b3' = b3 + 2 if am < s 

334 A10 restore am 

2l B1 and B2 contain positive integers n1 and n2. Fomi n1 x n2 
in store location 5 as a f ixed-point integer, r3presented by 
mantissa n1 x n2 x S"^^ and zero exponent. Replace b1 by the 
integer quotient nl/n2, and place the remainder from this 
division in B2. Let locations 6 and 7 be available for working 
space. 

113 1 6.4 set b1, b 2 in the store 

113 2 7,4 as floating-point numbers 

113 6 with zero exponents 

113 7 

334 6 am' = n1 X er^^'^ 

352 7 a' = n1 X n2 X 5*=^ 

365 J4 a' = n1 X n2 X ff'^^ 

i.e. 1' = n1 X n2 X ar^^ 

357 5 store 1 = n1 x n2 x ff"^^ 
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545 6 set nr in L with m' = sign 

of n1 = 0. ax* = n1 xS"^^ 

375 7 1' = (nl/n2) x ar=^^. m' = 

remainder x ^^^ 

store remainder an 

shift up quotient to integer 
position. 1' = (nl/n2) x 8"^^ 

store quotient 1= (nl/n2) x 8"^^ 

set b2' = remainder 

set bl ' = quotient 

Note that in this example it is not necessarj^ to set the exponent 
zero after division because ay is made zero during the multiplication 
and both division operands have zero e:!5)onents« 
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Chapter 7 

EgPMCQDE INSTRUCTIONS 

7,1 Introduction 

The basic instructions consist in just those simple operations which 
the computer has been designed to execute directly. In the Atlas oixLer-code, 
however, there are many complicated operations which the computer deals with 
in a special way; these are known as exrcracodes and are distinguished from 
the basic instructions by having a 1 in f , the most- significant bit of the 
10-bit function number. Upon encoimtering an instruction with f =3-1, there 
occurs an automatic entry to one of many built-in subroutines, the choice 
being determined by the remaining three octal digits of the function number*. 
The exit from the subroutine is again automatic, and the program proceeds in 
the usual way with the instruction next after the extracode, unless the extra- 
code subroutine has initiated a jump. 

7.1.1 Uses of the E:;d:racode Instructions . 

As their name implies, the extracodes provide an extension of the 
basic order-code, including both those complicated operations which are ex>* 
eluded from the basic instructions, and mary of the facilities v^-hich on pre- 
vious machines have been obtained by the use of library subroutines. 

Anongst the arithmetic instructions provided by extracodes we may 
instance those in which the address, interpreted as a floating-point number, 
is used as an operand; double-length operations; and a full range of ele- 
mentary functions such as logarithm, square-root, sine etc. 

Ad. imix)rtant '^rou'n of extracodes deals with the special renuireinents 
of input and output and also of magnetic tape transfers; the uses of these 
will be discussed at some length in Chapters 8 and 9. 

The organisational extracodes comprise extensive facilities designed 
to assislr the progranuaer in maklns efficient xcse of i±e operating system of 
Atlas. The various aspects of this are described in later Chapters (par- 
ticularly Chapters 11 and 12). 

7.1.2 To the programmer, ex±racode instructions appear as basic instruc- 
tions. The two types of instruction can be freely intermixed, and after 
each instruction control passes sequentially to the next (except for jump 
instructions). It is therefore not strictly necessary to know how the 
computer deals with extracode instructions, although this is given for com- 
pleteness in the next section. 

There are 512 function numbers available for extracodes, 1000-1777. 
Of these, 1000-1477 are singly-modified instructions (B-type) and 1500-1777 
are doiibly-modified instructions (A-type). In some of the B-type instruc- 
tions, bm is used as an operand so no modification takes place. 
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^•2 The loglcaJ. Interpretation of Extracode Instructions 

^Vhen an exfcraoode instruction is encountered the following action 
takes place :- 

(a) The content of Main control, 'h^27, is increased by one to the 
address of the next progrfun instruction, 

(b) The address is modified according to the type (i,e, N + bm 

for B-type, N + ba + bm for A-type) and the result stored in B1i9, 

(o) The seven Ba digits are placed in bits 15-21 of Bi2i, unless Ba 
is Bi22 in which case Bi21 is left unchanged; this enables B122 
to be used to specify a B-register in extracode functions 
exactly as in basic functions, 

(d) The function digits f1 - f 9 are placed in extracode control, 
Bi26, as shown below. 

Bit 1-9 10 11 12 15 14 15 16 17 18 19 20 21-23 

Value 1 f1 f2 f 3 f4 f5, f6 f7 f8 f9 000 

(e) Control is switched from Main (B127) to extracode (B126), 

The next instruction to be obeyed is now in the fixed store, imder 

extracode control. At n. Toncv+.-inn rl#a.+<»T«in-iTi<»/? Vnr +V.o ■P-.-.-^n-i-Ary^ ^^„^4.„: TX J _ _... 

one of 64 registers (given by f4-f 9) in one of 8 tables at intervals of 256 
words (given by f1-f3). The tables of 64 registers are called "jump tables". 
In general this instruction will be an unconditional jump into a routine 
which performs the required function. Tliese routines are permanently stored 
in the fixed- store and written in normal basic instructions, Sach routine 
terminates v^ith an instruction in which f1 = f 3 = 1 in the function number. 
This is obeyed as if f1 = and then control is switched back to main control 
(e.g. 521 is equivalent to 121 followed by "extracode exit"). The next in- 
struction to be obeyed is then the one whose address is in B1 27; if no jump 
has been initiated by the extracode this instruction will be the one immed- 
iately following the extracode instruction. 

The routines that perform extracode s can use B-register s 91 to 99 
inclusive and always use B119, B126, and B121 (unless Ba = 122). 

Examples: 

1, Extracode 1714 is defined as am' = l/s 

Replace the numbers in locations 100 to 105 by their reciprocals, 

,121 1 5 set modifier/count 

2)1714 1 100 am' =s 1/s 

356 1 100 store 

203 127 1 A2 count 

Each tijne the extracode instruction is encountered bi27' = b127 +1, 
b12l' = 0, b119' =» 100 +1ii +bO, b126' = J40034140 = +1804J4 and 
control is switched to B126, The instruction in the jump table is 

121 126 A14 
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The irustruotions at Ai4 are 

-14)334 A96 set am = 44 

774 119 374 division 1/8, then reswitoh to 

main oon'bTol* 

96)+i 

2. Extracode 1341 is defined as ba' = ■ba.2^ (arithmetic shift up) 
Shift b16 up by 2 more than the integer in B17 

1341 16 17 2 

This instruction sets b121 ' = 16D1, b119' = 2 +1»17, eto, (Note 
that bl6 is not added to b119 because 1341 is a singly-modified 
(B-type) extraoode)* 

3. Shift the contents of B20 to B47 inclusive up by 5 places, 

set B121 pointing at B20. 

shift. As Ba = B122, bl21 is left 
unchanged when t he extracode is 
entered* 

bt' =b121 - 47D1 

If bt 5<4 0, bl21 ' = M^ ♦ a,4 
aid. b127' = A1 

Example 3 illustrates the use that can be made of B121 and B122 in 
extracodes; this is the same as their use in basic instructions except that 
extracode s vdLth Ba 7^ 122 Virill overwrite B121* 
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7.3 Allocation of Functions 

The extracodes are divided into sections as shown below, though 
there are a few functions which do not fit into this pattern. References 
etre given for those subjects described in this chapter. 

Functions Subjects Reference 

i000-i077 Magnetic tape routines, and Input and 
Output routines* 

11 00-1 177 Organisational routines. 

1200-1277 Test instructions and 6-bit character 

operations 7.6 & 7.5.2 

1300-1377 B-register operations. 7.5.1 

1400-1477 Complex arithmetic, vector arithmetic 
and miscellaneous B-type accumulator 
routines. 7.4.6 & 7.4.7 

1500-1577 Double-length arithmetic and accumulator 
operations using the address as an 
operand. 7.4.4 <S: 7.4.5 

1600-1677 Logical accumulator operations and half- 
T/ord packing. 

1700-1777 Arithmetic functions (log, exp, sq.rt., 
sin, cos, tan, etc.) and miscellaneoiis 
A- type accumulator operations. 7.4,1,7.4.2 & 

7.4.3 

Not all of the 512 extracode functions have been allocated and, 
where convenient, constants and extracode programs have been packed into 
the vacant jump-table locations. 

This means that the use of an unallocated extracode function 
may result in an 'unassigned function' interrupt or may oau»o some exfcaro- 
code to be entered incorrectly. The latter case would give the programmer 
wrong re stilts. 

In particular, the first location in the fixed store, J4, contains 
the floating-point number ^» This causes an unassigned function interrupt 
if extracode 1000 is encountered, since J4 is the first register of the 
first jump-table. Note that floating-point zero is equivalent to the in- 
struction 

1000 ,0 0. 

There follows a description of many of the extracodes. f/here 
possible, the actual number of basic instructions obeyed in each extracode 
routine is given in the right hand colxamn. 

Appendix S gives an ordered summary of all the extracodes, for 
easy references. 
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7.4 The Acomaulator Exfcraoodes 

'^* ^* ^ The Most Used Arithmetio Functions 

The following routines each have two extracode numbers* The first 
operates on s, which is standardised on entiy. The second operates on a^ 
which is standardised, rounded and truncated to a single-length number on 
entry. For this number we use the notation aq. The results are always 
standardised rounded numbers in Am. 



i700 Place the logarithm to base e of s in Am. 

1701 Place the logarithm to base e of aq in Am. 

1702 Place the exponential of s in Am. 

1703 Place the exponential of aq in Am. 

1710 Place the square root of s in Am. 

1711 Place the square root of aq in Am. 

1712 Fora the square root of (aq*^ +»'^)and 
place this in Am. am 

Following the two arc sine extracodes, am' is in radians, with 



am 

am 
am 
am 
am 
am 



ae log s 
=E log aq 
=r exp s 
= exp aq 
= +4 s 
= +4 aq 



45 
42 

^2 

<41 



+ J aq=^ + s^ ^0 



-IT < am < +ir 

T 2* 

1720 Place th^e arc sine of s in Am. 

1721 Place the arc sine of aq in /jSi. 

Following the two aro cosine extracodes, am' is 
< am' < ir 

1722 Place the aro cosine of s in Am. 

1723 Place the arc cosine of aq in Am'. 

Followir'^ the two aro tangent extracodes. 
-I- < am' < IT 

1724 Place the arc tangent of s in Am 

1725 Place the arc tangent of aq in Am* 
1726 



am SB. aro sin s 
am' =a aro sin aq 
in radians, with 

am' =s arc cos s 
am' = aro cos aq 
am' is in radians, with 

am' =! aro tan s 
am' =s arc tan aq 



1730 
1731 
1732 
1733 



Divide aq by s and place the arc 
tangent of this number in Am. am' is 
in radians ond such that 
-^ < am < w» 

*Place the sine of s in Am. 



*Plaoe the sine of aq in Am. 
*Plaoe the cosine of s in Am. 
*Plaoe the cosine of oq in Am. 

1734 *Plaoe the tangent of s in Am. 

1735 *Plaoe the tangent of aq in Am. 
In 1 730 -1 755, s and aq must be in radians • 



am 


=s arc tan 


(aq/. 


am' 


' =s sin s 


41 


am 


' ss sin aq 


40 


am 


' =a cos S 


42 


am 


' =: cos aq 


41 


am' 


' =3 tan s 


54 


am 


' =a tan aq 


33 
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7,4*2 Ot her Floa ting-Point Arithmetic Pimotions 
1704 Plaoe the integer part of s in A. 
1706 Place the integer part of a in A. 
See also 1300 and 1301. 

1706 Set a' =+1, or -1 as s >, =, 

or < 2561*0. 

1707 Set a' =+i, or -1 as a >, =, 

or < zero. 

1713 Raise aq to the power s and place 
the result in am, provided that 
aq. > 0, Fault if aq < 0. 

1714 Place the reciprocal of s in Am. 

1715 Place the reciprocal of am in Am. 

1754 Round am "by R+, clear L and stan- 
dardise. 

1756 Interchange the contents 
of S and Am (v/ith no standardising) 

1757 Place the result of dividing s by 
am in Am. 

1760 Square the contents of Am 

1774 Divide am by s and place the result 
in Am. The original numbers need 
not be standardised. 

1775 Divide aq by s and place the result 
in Am-. The original numbers need not 
be standardised. 

1774 and 1775, besides providing a division instiruotion v/hich operates on 
Tinstandardised nimbers, store information Virhich enables extracodes 1776 and 
"»407 to calculate a quotient and remainder. 

1776 \7hen used after division extracodes s' = quotient QREDO 13 
1774, 1775, 1574 or 1575, with no am' == remainder 

other extracodes in bet?:een and am 
unaltered, the definition of 1776 
is as follows; 

Place the quotient of the previous 
division in s and the remainder in 
Am, where the remainder has the sign 
of the divisor. 

1407 As 1776 except that the quotient is s' = adjusted 

integral and is adjusted according integral quotient 

to the sign of the remainder, which QEDO 

is specified by Ba as follows: am' =s remainder 

Ba Sign of remainder 

Same as the denominator 
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1 Opposite to the denomijmtor 

2 Sane as the nimerator 

3 Opposite to the numorator 

4 Sane as the quotient 

5 Opposite to the quotient 

6 Positive 

ba 

1467 Evaluate the polynomial ■. an' = S s .an 

So + sa. .an + sa.an^ + ••>• s, '.an v^D 

v/here sq is the number at where S = S + r QBE S+Sba 

S, a± at S +i, etc. and the order 
of the polynomial is given as an 
integer in Ba,. 

"1466 l^ultiply the two numbers at a' = a + C(N4bn) 

addresses (N + ba +bn) and x C(NHba+bm) 

(N +bm) and add the double- QE 18 

length result into the full 
accumulator. 

Rounding takes place near the 
least-significant end of L. 
(In detail, when the double- 
length product has been formed, 
its least-significant half is 
first added in M to the least- 
significant half of the original 
contents of A, This addition is 
rounded. The rest of the product 
and the original contents of M are 
then added into A without rounding). 

1415 Generate pseudo-random numbers (PRW's) in A and S (or S*) 

several ways. 

1. With digit 21 of S equal to 0, the PRN is placed in S 
and A. 

(a) If s*y=: 0, Bx > and a^x > 0, then s' vidU be a PEK 
in the range to 8^^, rcotan^^ularly distributed arxi 
fixed-point (i.e. saj' is a fixed-point PRK and sy' = sy). 
a' will be a PEN in the range to s*a>»8^y (with al' = s'). 

(b) If s*y=: 0, Sa? < and s*a; > 0^ then as (a) except that 
ranges become -8^^ to and -3'-'a>8^y^ to respectively. 

(c) If s*y=: anci. s^x < 0, then as (a) except tliat the 
PM's alternate in sign. 

2. With digit 21 of 3 = 1, the PRN's are generated in S* and 

A instead of S and A. The cases are as for 1, interchanging 
S and S* throughout. 
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3« Two successive uses of the extraoode, with digit 21 of S 
first = and then = i, and with sy= s*y=3 0, will set 
pen's in S and S*, both rectangularly distributed in the 
range to i« A will contain the product of two PM's and 
so will be distributed in the range to 1 with the pix)ba- 
bility -log a>daj of being in the neighbourhood da? of x* 

In all cases the generation process must be started with Saj 
and S*a? containing nimbers v/ith a random mixture of binary 
digits, but with their least-significant bits set to I. 

7 • 4, 3 Accumulator functions suitable for Fixed-Point Working 



1752 Sliift aaj up 12 octal places and siib- 
traot 12 from ay* 

1753 Shift m down 12 octal places in aa; 
and increase ay by 1 2# 

1755 Force ay to the number ny 

given in bits 0-8 of n, shifting aa? 
up or down accordingly, 

1762 Shift aa? up 12 octal places leaving 
ay unchanged, 

1763 Shift ra down 12 places in aa?^ leaving 
ay unchanged, 

1764 Shift aa; up n octal places, leaving 
ay unchanged. If n is negative, 
shift aa? in the opposite direction. 

1765 Shift aa; down n octal places, leaving 
ay unchanged. If n is negative shift 
aa? in the opposite direction* 

1766 Place the modulus of s in An, without 
standardising. Accumulator overflow 
will occur if s is -1,0. 

1767 Place the modulus of am in Am without 
standardising, AO will occur if am 
is -1,0, 

1772 Multiply m by sa?, shifting the result 
up by 12 octal places to be in L, and 
subtracting 1 2 from ay. 

1773 Divide a by s, and force ay equal to 
12, shifting the resiilt, which is in M,ay 
if necessary, 

1452 Multiply am by s, forming the answer aa? 
in Aaj» Force ay to the number given ay 
in digits 0-8 of ba, and shift aa; 
accordingly, 

1473 



m' 


= aa?.S-" 






ay' 


= ay - 1 2 


AO 


10 


aa?' 


= ni,8-" 






ay' 


= ay +12 


AO 


6 


aa?' 


=s aa;»8 ^ ^ 






ay' 


-ny 


AO 


17 


m' 


= aa;»o 


AO 


9 


ay' 


= ay 






aa;' 


= ni.r" 


AO 


5 


ay' 


= ay ^ 






aa;' 
ay' 


= aa?»8 
= ay 


AO 


17 


aa?' 


= aaj.S" 


AO 


12 


ay' 


= ay 







am 



am 



ay 



Divide aa; by sa;, forming the answer 
in Aa> Force ay to the number given 
in digits 0-8 of ba, and shift aa; 
accordingly. 



aa; 

ay 



=.|s| 



= am 



AO 



AO 3 



= (m,sa?)^^ AO 11 

= ay + Sy -1 2 

= (aa/sa;).8^irsyi3 
= 12 AO 27 



m.sa;.8^y^V^^y 

bay AO 1 9-23 



(aa/sa;).8^V"^^^^V 
bay AO 24-28 
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Fixed-Point Divisions with Remaiaier 

The three extraoodes i474, -1475 and i476 each divide some part of 
the accumulator by the contents of store location S, placing an xmstandar- 
dised quotient q in the location whose add2:^ss is ba and leaving an unstan- 
dardised remainder r in Am. In all oases, r retains the original sign of am 
and has a mantissa in the range < |ra;| < |sa;|. The quotient is rou»ied 
towainis zero. Division overflow is set if so; == or -1,0 or if 
|sa;| < I mantissa of dividend |. Both DO and AO are set when the mantissa 
of the dividend is e'^ual to — "l^Os 

If only the remainder is required, one can avoid the need to set ba 
by putting Ba = Bi 26 in the extracode instruction. 



C(ba)' = DO 
quotient (am/s) AO 
am'== remainder (am/s) 

C(ba)' = ^ DO 
quotient (a/s) AO 
am' =: remainder (a/s) 

C(ba)' = /q int pt am 



/ int pt am\ 



20-29 

E 
i9-28 



AO 

DO 

E 



1474 Divide am by s. The exponents of 
q and r are given by qy=3 ay - sy 
and ry= ay- 45, 

i475 Divide a by s. The exponents of 
q and r are given by qy= ay - sy 
and ry = ay - 13 

1476 Divide the integral part of am 
by s, !Ehe exponents of q and r 
a37e forced to qy= 24 - si; and 
ry =! 12. The condition am ' = r 

jam I < 8^"* jsajj must be observed, 
otheiTwise division overflow will 
occiir and the results will be 
meaningless. The least- signif- 
icant octal digit of q is always 
zero, and it is intended that 
usually sy= 12 so that qy=: 12 
also and one is working with in- 
tegers. (In the case ay < -6 
and am. < 0, this extracode must 
be preceded by 21 7, 1 24, 1 24, 
to ensure the t rue integral part 
is used). 

7.4,4 Double-Length Arithmetic 

The double-length nimber s: is stored in two consecutive locations 
sand s + 1 as two standardised floating-point numbers, where sy- 13 > s*y* 
s' and al are assumed to be always positive. All arithmetic is standar- 
dised, rounded and checked for eaqponent overflow, 

1500 Add s: to a 

1501 Subtract s: from a 

1502 Negate a and add s: 

1504 Copy s: into a 

1505 Copy s: negatively into a 



28-37 



a' 


= a + s: 


10 


a' 


= a - s 


10 


a' 


= -a + s: 


14 


a' 


=: s: 


4 


a' 


= -a: 


3 
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a' 


= a.ss 


15 


a' 


=3 -a;«s: 


i9 


s:' 


^ =s a 


5 


a 


' = -a 


5 


a* 


= |a 


4-6 


&' 


' = SI 


5 


a,' 


= a/s: 


i9 



am' = am 


+ n 


ORE 


10 


am' = am 


- n 


ORE 


9 


a' = n 




Q 


8 


a' =s -n 




Q 


7 



7.4/6 

1542 Multiply a by s; 

1543 HuiLtiply a negatively by s: 
1556 Store a at S: 

1565 Negate a 

1566 Form the modiilus of a 

1567 Copy the modulus of s: into A. 
1576 Divide a by s: 

7»4,5 Arithmetio Using the Address as an Operand 

The modified address is taken as a 21 -bit integer with an octal 
fraction. Fixed-point operations imply an exponent of 12. 

1441 Store ba in S as a fixed-point sx* = ba, Sy' = 12 6 
number 

1520 Add n to am 

1521 Subtract n from am 

1524 Place n into a 

1525 Plaoe n negatively into a 

AcaA -m „ J „j.>» » _J J.1 — ..4. «-i-^»>J»^^4 ..4 ^~ 

a'=n 10 

1535 Place n negatively into a, without 
standardising 

1562 tlultiply am by n 

1574 Divide am by n 

1575 Divide aq by n 

After 1574 and 1575, the extracodes 1776 and 1407 can be used to give a 
remainder and adjusted integral quotient. See section 7.4.2. 

7.4,6 Complex Arithmetio 

The "complex accumulator* Ca is taken as a pair of consecutive re- 
gisters, the address of the first one given b3' the contents of Ba in the 
instmiction. If 3a is BO, Ca will be locations and 1. As with the double- 
length arithmetic, s: is a number pair consisting of the two numbers at 
addresses S and S + 1. For Ca and S:, the real part of the nimber is in the 
first looation, the imaginary part in the second, Ca may coincide with S: 
if desired, but the two must not partially overlap, i.e. the difference be- 
tween ba and S must not equal 1. The accumulator is used for the arithmetic 
so its original contents on entiy are spoiled. All arithmetic is standard 
dised, rounded and checked for exponent overflow. 

1400 Place the logarithm of s: in Ca oa' = log s: 

1402 Plaoe the e3cponential of s: in Ca 

1403 Plaoe the conjugate of s: in Ca 
1410 Place the square root of s: in Ca 



a' = -n 




9 


am' = am.n 


QHH 


8 


am' = am/n 


QBE 


16 


am' = aq/n 


ORE 


15 



ca = exp s: 


140 


ca' = conj s: 
ca: =a +J s: 


5 
^17 
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oa' =s oa - s: 


8 


oa' =s s: 


6 


ca' = -s: 


6 


s:'' M oa 


5 


ca' = oa«s; 


18 



7.V^ 

1411 Place the argument of s; am' =s arg s: 

(radians) in M. 

1412 Place the modulus of s: in M» am' = mod s: ^3 

1 41 5 Form the numbers s cos s* , s sin 

s* and place these in Ca. (s* is oa' := s*oos s*, 95 
in radians )• j^.sin s* 

1414 Place the reciprocal of s: in Ca. oa' == l/s: 15 

•14-20 Add °» to 0° /><»' -— <>*> *- "i 8 

1421 Subtract s: from oa 

1424 Copy s: into Ca 

1425 Copy s: negatively into Ca 
1456 Copy ca into S: 
1462 Multiply oa by s: 

Note : 1400 - the imaginary part of the complex logarithm will lie 
in the range - w; (not inclusive) to w (inclusive), 
1410 - of thetv^o possible valiies of the complex square root, 
the one comptited here has a non- negative real part; the re- 
maining ambigiiity about the square roots of negative real 
numbers is removed by computing the one whose imaginary part 
is positive. 

7.4,7 Vector i^rithmetic 

The following instructions operate on tv/o vectors g± and sg. Both 
vectors consist of lists of floating-point numbers stored in successive 
locations. In each instruction the singly-modified address n gives the 
number of terms in the vectors (i.e. the order) and Ba gives the starting 
address of si. The next B- register after Ba, Ba*, gives the starting 
address of sa. Mdress n mtist be a positive integer. 

Besides their uses in vector and matrix arithmetic, these in st motions 
can be used to manipulate lists of numbers in the store. 

The accumulator is used in the arithmetic so its original contents 
on entry are lost. AH operations aire standardised rounded and checked for 
exponent overflo\*. 

1430 iidd the vector sa, which consists Si'=:fii+fl8 9+4n 
of n BUocessiTe numbers starting 

at C(Ba*) into the vector si, 
v/hich consists of n successive 
numbers starting at C(Ba)# 

1431 Sxib tract sa f3:*om ©t. 

1432 Hultiply each term of sa by am 
and store the resultant vector 

at si. 

1433 Multiply sa by^am and add tliis to 
Si. 



( 1.65 ) 



Si «± Si - fla 




9 + 4a 


8± = am.Sa 




10 +4n 


si ' = si ♦ am. 


Sa 


10 + 5n 



1434 Copy s to s s ' =» s 13 + &i 

1436 Form in Am the scalar product! n-1 

s :.s + ..• + s , \ •s \, am' = E ^,a'^ a 

10 ao i(n-4) a(n-<} isdO 

where s , s , s . ••>• . 

10 11 13 

s , ' are the niambers in S , and 
i(n-(!.) 1 

s ,s .««•• are the nimbers in s • 
20 21 a n-1 

1437 As 1436 but forming the scalar a' =: Z s ..s 10 +I3n 
product to double-length i=£) 

accuracy in a« 

7,4,8 HalP^Yford Packing 

Half-word floating-point numbers consisting of 8-bit exponents and 
16-bit mantissae are sometimes useful for low-accuracy calculations where 
it is necessary to reduce store usage, 

1624 Transfer the floating-point nxmiber a' = a 6 

at S into the accumiiLator, without 
standardising. 



1626 Copy ay and the 16 most- significant s 
digits of arc into S after rounding 
this number in Am by forcing a 
one in its lowest bit if the rest 
of aa? is no n- zero. 



=a am 
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7»5 B-Register Arithmetic 

T'.S.i General B»Register Operations 

1300 Place in Ba the integral part of ba* = int pt of e 
the floating-point number s« am' = frac pt of s 
Place the fractional part in j\m« 

1301 Place in Ba the integral part of ba' = int pt of am 
am. Place the fractional part am' = frac pt of am. 
xn xim. 

The following six instructions provide integer multiplication and 
division of ba by n. 

For 1302 - 1304r, ba and n are interpreted in the normal way as 
21 -bit integers with a least-significant octal fraction. In the multipli- 
ction instructions octal fractions are rounded away from zeix), and over- 
flow of the answer is not detected. The accumulator is used in the calcu- 
lation, but am is preserved, 

1302 Multiply ba by n and place the ba' = ba x n 23-24 
result in Ba. 

1303 Multiply ba negatively by n and ba' == -ba x n 22-23 
place iiie result in Bai, 

1304 Divide ba by n. Place the in- ba' = int pt (ba/n) 
teger quotient in Ba and the 25-28 
Remainder, which has the sign of b97' = remainder 

the dividend, in B97, 

For 1312 - 1514, ba and n are interpreted as 24-bit integers, and 
the result is again a 24-bit integer, 

1312 Multiply ba by n and place the ba' = ba x n 25-24 

result in Ba, . 

'^ Fi^ ?i Twill +.TnTv Via r\p> iTQ-t"? \Ti^l yr Trir n >.« ' _Vn x^ -n 00_0«^ 

. «-• . w ... >.w> v_.j^_YA ~v» *-v. Qw, «— . .^.-.jr %^j *.^ wot — - — WQ /\ ** tJtJ—tJtJ 

and place liie result in Ba, 

1314 Divide ba by n. Place the integer ba' = lut pt (ba/n) 
quotient at the least- significant b97' = remainder 

end of Ba and tfee. remainder, which 

has the sign of the dividend, as a 
24-bit integer in B97, 

The following six instructions provide general n-plaoe shifts of 
numbers in B-registers, 

In arithmetic shifts, the sign digit is propagated at the most- 
significant end of the register for shifts to the right (i.e. down). 

In logicEil shifts the sign digdt is not propagated. 
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For both arithmetic and logical shifts the result is unroiinded on 
shifts down. In circular shifts, digits shifted off the most-significant 
end of the register reappear at the least- significant end and vioe-versa# 
n is an integer in bits 0-20 as usual, with no octal fraction, (If n has 
an octal fraction the answer may be wrong by a shift of one place). In 
each case, if n is negative a shift of n places in the opposite direction 
occurs. 

1540 Shift ba arithmetically to ba'=:ba.2r^ iO-22 
the right by n places. 

1341 Shift ba arithmetically to ba'=ba.2" 9-21 
to the left by n places. 

1342 Shift ba circularly to the ba' r=b£i.2r^, 10-19 
right by n places. circular shift 

1543 iShift ba circularly to the ba' = ba.2^, 9-18 
left by n places. circular shift 

134-4 Sliift ba logically to the 10-21 

right by n places. 

1345 Shift ba logically to the 9-20 

left by n places. 

The following are miscellaneous arithmetic instructions on half- 
words and index registers. 

1 5^17 Pera^ora the logical "OR" s ' = ba v s 5 
operation on ba and s and 
place the result in S. 

1353 Set Bl2aby writing n to it, b123' = n, 

aiid read tlie result to Ba. then ba' = b123 
This sets ba equal to the 
position of the most-signi- 
ficant 1 bit in bits 16-23 
of n. (B123 is described in 
Chapter 4. ) 

1356 Set the B-test register as bt' = ba ^ s 7 
the result of non-equivalen- 

cing ba and s. 

1357 Set Bt as the result of non- bt' = ba ^n 5 
equivalencing ba and n, 

1376 Set Bt as the result of col- bt' =:ba <S s 5 
lating ba and s. 

1377 Set Bt as the result of col- bt' =iba <& n 
lating ba and n. 

1364 Preserve the digits of Ba where ba' = (ba & ft) v (bn & n) 
there ere zeros in n and copy 4 

digits from Bm into Ba where [also b11-9' = 
there are ones in n« (ba )4bm) & n] 

1371 Dummy extraoode to set up b12l' = Ba, 

b121 and b119. b119' = N + bm. 
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1 771 Dummy exfcraoode to set xq) b1 21 ' « Ba- 

bl21 and b119. b119' = N + ba + bci, 

7« 5« 2 Charaoter Data Prooessing 

1131 Search for s in table starting 

at C(ba). If s can be found, ba' 
will record its addi^ss, otherwise 
the sign bit of ba' will be set to 1, 
Main control is re-entered at c' =» 
0+2, and C(o +1) is used to speoifjr 
parameters k, 1, m as shown below, l^ 
to 1 + 1 half-words are scanned, stars- 
ting with C(Ba) and continuing at in^ 
tervals of k half-words, each being 
masked with m before c omparison with ^, 

bits 0-9 10-20 21-23 0-23 

k 1 spare m 

interval oount mask 

^u u. ?^J^^ following tsiro instructions S is talcen as a charaoter address, 
the octal fraction giving the address of the 6-bit character within the word, 

1250 Place the character s in the ba' = char s 7-10 
least- significant 6 bits of 

Ba and clear the other digits 
of Ba. 

1251 Copy the character from the s' = char ba 11-18 
least- significant 6-bits of 

Ba into the character position 
at S, leaving the other charac- 
ters in the word unaltered. 

In the following tsro instructions ba is interpreted as a character 

, ^.^ „^.^ w.^*xwv.i*u wx i,xi^ Aic^Au £>-x-t;gj.ai,ei-. Da", IS inxerprc'CecL as a 

half-woixi address, n is used as a count and its octal fraction must be 
zero. 

1262 Ifopack n characters. The n 16 + int pt (e^n) 

chacaot.ersL^.,.paj3ked ija..sucoe©sive - * 

charaoter positions starting at 
C(Ba), are placed in the least- 
significant 6-bits of n succes- 
sive half-words starting at 
C(Ba*). The other digits in 
each half-word are set to zero. 

1253 Pack n characters. Take the n 18 + 6n 

characters stored in the least- 
significant 6-bits of n succes- 
sive-half-words starting at 
C(Ba'') and pack these into n 
successive character positions 
starting at C(Ba). 
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7«5,3 Logical Accumulator Instructions * 

B98 and B99 are used in these instructionc as a double-length 
B-register. This is called the logical accumulator and denoted by &• 



1204 StrTting at the most-signif- 
icant end, count the number 
of 6-bit characters which are 
identical in g and s, con- 
tinuing only until the first 
dis similar characters are 
found. Place the result in 
Ba. 

Shift g up by 6 places, 
vn?iting overspill to Ba, and 
add n. 



10-31 



1265 

1601 
1604 
1605 



Copy s into G. 

Add s into G. 

Add s into &, adding any 
oveidoviT carry in again 
at tho least-significant 
end, 

1606 No n- equivalence s with g 

1607 Collate s with g 

1611 Replace g by its logical 
binary complement. 

Copy g into S 

Copy g into Am, without 



1613 
1615 

1650 

1655 
1646 
1652 



standardising. 

Form the logical binary 
complement of s and collate 
this with s« 

Copy am into &. 

"OR" s with g 

Set Bt by the result of 
subtracting s from g» 



ba' = m,s, character 



of g. 
g' = 2^g 4n 

g' = s 

g' = g + s 

g' = g + s with 
end-around cairy 



g' = g ;4s 

g' = g & s 

S' =:-g 

am' = g 
g' = r^ & 1 



g = am 
g' «= g V s 
bt' = g - s 



11 
3 
7 

12 



4 

3 

7-9 
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1 m 6 Test Instxiictions 

7,6.1 Aooumulstor Test Instruotlons 

1200 Plaoe n in Ba if the AociJinulator ba' ^ n if AG 9 
overflow (AC) is set. Clear AO* is set. 

1201 Place n in Ba if AO is not set. ba' = n if AG 7 
Clear AO. is not set. 

1234 Increase main control by 2 o' = c+2if 11 
( instead of by 1 ) if am is am ^^ s 

approximately equal to s. " 

1235 Increase main control by 2 if am c' == o + 2 if 11 
is not approximately eqiial to s', am^s 

For 1234 and 1235, approximate equality is defined as 



am - s 



am 



< C(ba) 



am must be standardised on entry. By definition, if am = then am is not 
approximately equal to s. 

1236 Place n in Ba if am is greater ba' = n if 4-6 
than zero. am > 

1237 Plaoe n in Ba if am is less than am < G 3-5 
or equal to zero. 

1255 Plaoe n in Ba if m is neither ba' = n if 

zero nor all ones. ^ ^ all I's or all O's 

1 727 Depending on v/hether am is o'=:o+1, 7 

greater than, equal to, or 2, 3 as am >, 

less than s, increase main =:, < s 
oontixDl by 1, 2 or 3. 

1736 Increase main control by2if o'=30+2if 
the modulus of am is greater I ami > s 
than or equal to s. ~ 

1737 Increase main ooatrol by 2 if o' =;= o 4. 2 if 
the modulus of am is less than s. jamj < s 

In 1234, 1235, 1727, 1736 and 1737 am is preserved but 1 is not. 

7. 6, 2 B-register Test Instructions 

1206 Place n in Ba if the most 4 
significant 6-bit character 
in G- is zero. 
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1216 PJjEioo n da Ba if bn d*.. ba' « n if 
greater than zero. bm > 

1217 Place n in Ba if bm is less ba' :U n if 
than or equal to zero# bm < 

1226 Place n in Ba if bt is ba' = n if 4-6 
greater than zero, bt > 

1227 Place n in Ba if bt is less ba' = n if 3-5 
than or equal to zero» bt ^ 

1223 Place n in Ba if the B-oariy ba' = n if 

digit is set. bo =s 1 4 

The B-carry digit (Be) is set to a or a 1 in the following basic 
instruotiontf. 



100 


102 


104 


110 


112 


114 


120 


122 


124 


150 


152 


164 


170 


172 





Bo records the final carry or borrow generated after the addition or siib- 

\ilhen the most-significant digit is taken as a sign bit, which is 
usually the case. Bo is not a true overflow digit. For example, adding 
-1 or +1 gives and also sets Bo = 1 as there i^ a final carry* 
(See Chapter 4), 
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7«7 Siibroutine Entry 

iiOO Set liiik in Ba and enter 
subroutine at s* 

1101 Set link in Ba and enter 
subroutine at n, 

1102 Set link In Ba and enter 
subi*outine at bia» 

1562 Set liiic in B90 and enter 
subroutine at n. On com- 
pletion of this extraoode, 
b1 21 ' s= Ba, so that 3a or ba 
may be used to carry infor- 
mation into the subroutine;* 



ba' 


= +1, 


6 


c' 


= s 




ba' 


= 0+1, 


5 


o' 


= n 




ba' 


= + 1 , 


6 


o' 


= bm 




j90' 


=.0+1 


3 


c' 


=: n 





The link set in Ba can be picked up as an exit from the subroutine 
by the instruction 



121 127 B^ 







where B|, is the address of the B-register (Ba) in which the link was set. 
It is conventional to use B90 for this purpose, and 1 362 was provided for 
that reason* 
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7«8 Miscellaneous Operations 

^^^7 End program. This exfcracode 
is used to end a program un- 
less it is monitored by the 
Supervisor. Certain infor- 
mation about the program is 
output, and the program cleared 
f3?om the computer, (see Chapter 

11.) 

1 1 20 Record the time in Ba, with 

hours, minutes and seconds each 
givem by two decimal digits 
specified in four bits apieoe, 
as follows:- 



ba' =! clock 



1i21 



1124 



bits 0-5 4-7 
tens units 
HOURS 



8-11 12-15 
tens uidts 

uimm:s 



Record the date in Ba, with 
the day, month and year each 
given by two decimal digits 
specified in four bits apiece, 
as follows :- 



16-19 20-23 
tens units 
SECONDS 

ba' = date 



bits 0-3 4-7 
tens units 
DAY 



8-11 12-15 
tens . ixDdLts 

MONTH 



Set the central computer 
V-store line 6 to n. The 
least-significant six bits 
of V-line 6 are used as 
follows:- 



16-19 20-23 
tens units 

YEAR 

v6' =:n 



bit 
18 



Set to 
13 shift 



Set to 1 

12 shift on division; 
needed to 
adjust remaij^er 
for 376, 377 
instructions 



19 



20 



Qs > 



Qs < 



Sign of quotient 
in basic division 
orders 



AO clear AO set 



21 bt > bt < 

22 bt =a bt 9^ 

23 Bo clear Bo set 

1125 Collate the contents of the 
central computer V-store 
line 6 with n, placing the 
result in Ba. Ai^y digits 
of v6 may thus be read. 



ba^ = v6 & n 
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Chapter 8 

INPUT A?S) OuOIPuT 



This chapter e3cplains the use of Hbrory routines Li and L100 and 
the input and output extraoodes. It also shows the form in which input 
data must he prepared and explains the internal code used by Atlas as well 
as the handling of 'pure' binary informat5x)Eu 

8,1 Introduction 

8,1 #1 Peripheral devices * 

Atlas can control a large ntanber of input and output mechanisms and 
these peripheral devices ore of various fdrms^» Five- and seven-hole paper 
tape and punched card readers are used for input, while output may be pro- 
duced on paper tape, cards or a line printer^* 

The working rate for such peripherals is of the order of 10° char- 
acters per second. This is very slow compared with the processing rate of 
the central computer, which is of the order of 2 x "10^ characters per sec- 
ond. Clearly, conventional methods of input and output, din which each 
character is read from a peripheral as required or written away as soon as 
it is produced, would lead to considerable inefficiency in Atlas. For this 
reason, a 'buffering' system is adopted. 

8. 1 • 2 The System Input and Output Tap es. 

All the infoiTiiation required for a program is fed through the slow 
peripherals and is automatically stored in a standard form on a magnetic 
tape. This tape is called the System Input Tape. Work on the program v/ill 
not begin until all the required information is stored in this way. Simi- 
larly the output from a program is stored on magnetic tape (the System Out- 
put Tape) and transferred to the peripheral only after the program is com- 
pleted. In this way the central computer can be occupied with other work 
while the actual transfer to and from the peripheral takes place. 

8.1,3 Internal Code Input and Output. 

Normally during the transfer from peripheral to the Sjystem Input 
Tape each character (i.e. a paper tape character or card column) is auto- 
matically translated into a six-bit character in Atlas Internal Cod^. Simi- 
larly each character for output is represented in this code on the ^-stem 
Output Tape. The six-bit characters are packed 8 to a word and stored in 
'records' (see 8.3 below). 

Seven- track input is cheoked for odd parity and rejected on parity 
failure. Rejection is prevented by preceding the seven track information 
by '»**p^ in which case an even parity character is replaced by the fault 
character K7.7 (six binaiy ones) and reading continues. There is no parity 
check when reading 5-track tape. If the first oolunm of a card is a nonr 
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standard pimching the oard is stored in binaiy (see 8,1 3) j if the first ool- 
umn is standard but subsequent columns are non-standard they are represented 
by the fault character K7.7, 

Equivalent characters on punched cards, five- or seveiuhole tape and 
the line printer, are represented by the same character in internal cod^. 
In this way one input routine can deal vdth input from any peripheral and 
one output routine oan build up output for any output mechanism. 

Thus, for ejiample, the character 'M% whether it has been read from 
five- or seven-hole tape or from cards, will be represented on the System 
Input Tape as 

K5.5 or, in binary 10i10i, 

Similarly if 'll' is to be output it mJul be stored on the System 
Output Tape in the same way, regardless of the output peripheral for which 
it is intended. Further details of the internal code are given in 8.2. 

Input and output in internal code ma;j^ be carried cut by either the 
input and output library routines L100 and LI or by input and output extra- 
codes. Both forms are described in detail belotf. 

8. "1.4 Binary Inpu t and Ou tput. 

The programmer can, if he wishes cause a direct binary representation 
of the holes on the paper tape or cards to be stored on the Systan Input Tape, 
instead of the internal code representation. Tliis is known as binary input 
and must be read by extracode and not the library routine L100. Each char- 
acter so stored will occupy i2 bits and. characters will be packed four to a 
word. 

For example, 'M' is represented on seven-hole paper tape by the 
character 

iOii.101 

where ones represent holes and the full stop represents a sprocket hole. 
As binary input this would be stored on the Sj'-stem Input Tape as 

000 001 011 101 

On the other hand the character 'm' is represented on a punched oard 
by holes in the '11 ' and '4' positions. As binary input this is stored as 
the 12 bit character 

010 000 100 000 

(see 8.15 and 8.16) 

In a similar fashion, by the use of extracode s, a twelve bit char- 
acter may be output in binary form. It will be stored on the System Out- 
put tape in this form and, when sent to the peripheral, holes will be 
punched in positions corresponding to the one bits. 

Binary input and output are particularly useful when dealing with 
non-standard paper tape or card codes. More details are given in 8.13 aid. 
8.16, 
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8.2 The Internal Code . 

Each character is represented in internal code hy six bits. When 
a single six-bit ch^aracter is held in a 24-bit index register it is usuallor 
stored in the least significant six bits. It is thus represented by two 
octal integers separated by a point, and this notation will be \ised thrxjugh- 
out this chaptei*. 

The use of six bits imposes an upper limit of 2^ or 64 distinct 
characters. To extend this rubber, two sets of characters are infc2?oduoed| 
the inner set and the outer set. Most of the commonly used characters are 
contained in the inner set, A character in the outer set will have the same 
six-bit representation as an ini^r set character but they will be distin- 
guished in the following way. 

Every line, whether input or output, begins in inner set and ?n 
characters are taken to be inner set imtil a 'shift to outer set' character 
is encountered. All characters will then be interpreted as outer set mem- 
bers until a 'shift to inner set' character or the end of the line is 
reached. 

On output, an internal code character which can not be represented 
by a character on the required peripheral vdJl be replaced by a full stop 
on the Anelex printer or the card punch, and by erase on 5 or 7 track tap6. 
Thus an attempt to print > on an Anelex printer would result in a full stop 
being printed. This also applies to non-printing characters such as back 
space and tabulate which are only available on seven-hole t*pe. 



8.2.i Abbreviations, 
used:- 



In the Internal Code Table of 8.2.2 the following abbreviations are 



3S = Back Space SI = Shift to Inner set 

SR =5 EEase SO = Shift to Outer set 

PS = Figure Shift SP = SPaoe 

¥S = Fault TB = TaBulate 

LC = Lower Case UC = Upper Ca^e 

LS = Letter Shift UL = UnderLine 

The availability of characters on tlie different peripheral devices 
is indicated as follows :- 

u All peripheral devices 

a Aneiex Line Printer 

7 Seven-hole paper tape 

Punched cards 

5 Five-hole paper tape 

Characters in parentheses are alternatives available on commercial 
seven-hole or five-hole paper tape codes, as used on Orion and Pegasus. 
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8.2,2 The Internal Code Table 



Internal 




Character 


Internal 




Character 


\ 


Code 


Inner Set Outer Set 


Code 


Inner Set 


Outer Set 


0.0 




1 ■ 


4,0 


'(») 


u 






0.1 




SF u 


4.1 


A 


u 


a 


7 


0.2 


TB 


7 




4.2 


B 


u 


b 


7 


0.3 


BS 


7 


£ a 


4,3 


G 


u 


c 


7 


0,4 




SO 


4,4 


D 


u 


d 


7 


0,5 




SI 


4.5 


E 


u 


e 


7 


0.6 




LC/LS 7/5 


4.6 


P 


u 


f 


7 


0,7 




UC 


/PS 7/5 


4.7 


G- 


u 


g 


7 


1.0 


s 


u 




5.0 


H 


u 


h 


7 


1.1 


u 




5.1 


I 


u 


i 


7 


1.2 


9 


u 




5.2 


J 


u 


j 


7 


1.3 


«•(£) 


u 




5.3 


K 


u 


k 


7 


1.4 


? 


u 


Stop 7 


6.4 


L 


u 


1 


7 


1,5 


& 


a7c 


Punch On 7 


6,5 


M 


u 


m 


7 


1.6 


« 


u 


Punch Off 7 


8.6 


N 


u 


n 


7 


1.7 


/ 


u 


: a7o 


5,7 





u 





7 


2.0 





u 


JJ(X) 5 


6.0 


P 


u 


P 


7 


2.1 


1 


u 


L a7o 


6,1 


Q 


u 


q 


7 


2.2 


2 


u 


1 a7c 


6,2 


R 


u 


r 


7 


2.3 


3 


u 


-* 5 


6.3 


S 


u 


s 


7 


2.4 


4 


u 


^ ^ 


6,4 


T 


u 


' t 


7 


2.5 


5 


u 


^ 5 


6.5 


U 


u 


u 


7 


2.6 


6 


u 


UL , a7o 


6,6 


V 


u 


1 V 


7 


2.7 


7 


u 


1 a7c 


6.7 


W 


u 


w 


7 


3.0 


8 


u 


^fS a7 
« (v) 5 


7,0 


X 


u 


X 


7 


3,1 


9 


u 


7.1 


Y 


u 


y 


7 


3,2 


< 


a7o 


eCflO) a7 

fl(l1) a7 
1 a7 


7.2 


Z 


u 


z 


7 


3,3 


> 


u 


7.3 










3.4 


= 


u 


7.4 










3.5 


+ 


u 


10 a 


7.5 










3.6 


- 


u 


11 a 


7.6 










3,7 


. 


u 




7.7 


FT 




7o 


ER 


75 



8.2.3 Shifts and Case Changes 

UC, LC, PS, and LS are not stored on input when they are used to 
change from one case or shift to another. Each of these characters merely 
alters the meaning of the characters which follow on the paper tape and 
this alteration will be allowed for when these characters are translated 
into internal codei. 
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Thus the sequence 
Tape (7) 
on seven-hole paper tape would be punched as 

TLCapeSP(UC7LC) 
but it would be stored on the system input tape as 

T SO a p e SP SI ( 7 ) 

Redundant sh±ft characters, such as PS when already in figure shift 
are stored, howc/er, since they may indicate a fault. 

Similarily UC, LC, FS and LS need not be used v/hen preparing output. 
The internal code representation of the character is specified and shift 
and case changes will be automatically inserted t/here necessary. 

For example outputting the internal code characters 

W2 
to five-hole paper tape will cause the characters 

LS ?; PS 2 
to be punched. 
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8«3 Carriage Control Characters and Records 

As mentioned in 8«i,3 input is stored on the System Input Tape in 
records. These records correspond to one line of printing on paper tape 
or one card ±f the input is on cards. The last character of a record is 
called a carriage control character and is not represented in internal code# 
Carriage control characters have a special code of their own# Input from 
paper tape or punched cards can give rise to only the following carriage 
control characters :- 

Code Character 

2, 1 Newline (7-hole tape) or End-of-card 

4r,0 Paper Throw (7-hole tape) 

2«0 Carriage Return (5-hole tape) 

O.i Line Feed (5-hole tape) 

These are abbreviated to NL, PT, CR and LP respectively. 

On output, recojrds are built up on the System Output Tape, The 
last character of each record is interpreted as a carriage cont2X)l character 
as follows :- 

Codes Effect 

0.0 to 1,7 to 15 line feeds without carriage return 

2,0 to 3,7 to 15 line feeds iTith carriage return 

4,0 to 4,7 Paper throv; on channels to 7 id-thout CR 

5,0 to 5,7 Paper throw on channels to 7 with CE 

Carriage control facilities, and hence the interpretation of carriage 
control characters, vary fixim one output device to another. 

The number of line feeds is always performed correctly but the fol- 
lowing restrictions apply to other facilities. 

On the Anel cx Line Printer 

Line feed and Paper Throw are always accompanied by carriage retiirn, 

Channel is the 'top of form' channel. Thus 4,0 and 5,0 mean 
carriage return to the top of the next form. Channels i to 7 
provide vertical spacii^ (always with carriage return) as determined 
by a loop of paper tape which is fitted to the paper throwing mech- 
anism of the i'jielex printer. 

The width of a line printed on the Imelex is 120 characters. If 
more than 120 characters are output to a line a new line is auto- 
matically begun and the excess characters are printed on it. 

On the Card Punch 

Line feed means 'next card'. 

Paper throw is replaced by one 'next card' (i,ei, 2.1 ) 
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Carriage return Is ignored:. 



m t^^Sl^iS oharaoters are outpirt to a oaril a new cai4 is auto- 



at the first oolmm. 
On Seven-hole TaDe 






^hoSt-^ ^:7',,^.'°l^^f. by carriage retom. Callage retu» 

oS?'°tZ'^L?'S'r rf^-./l^e paper thro, oharao^ ^tape win 
P^r*?So:^::^yf'^ fle».wrxter on which it is px^ted has a' 

On Five- hole Tape 

Paper throw is replaced by one line feed. 

^f^T.^'^J number for paper throw will he takm modulo m, where m is the 
number of homing channels available on the printer. m is the 

The carriage control character 0.0 is ignored bv each of +h^ ■?,.„•« 
types of equipment. The character 2.0 (carrda^^'^lt^out iSe feS^ 

e^tlTe Zl t "^ .°"^ °"'?^ "^ °°^^'*^ ^- on thfl^^yStir 
and 5-hole tape. Compound characters can therefbre be printed on the Ine! 
lex and the teleprinter by overprinting. P^^nxea on the iine- 
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8»4 Selecting Input and Output 

The data required by a program mciy arise from several different 
sources and each such batch of data may be prepared as a separate unit 
called a document. Each document will be on a separate paper tape or deck 
of cards and each will be allotted an input number as described in Chapter 
10. Similarly if several distinct sections of output are to be produced by 
the program each may be given an output number. 

Yihen the program requires input from a given document it first selects 
the number of that document by extracode. Similarly to send information to 
a given output stream, the output number must first be selected. The extra- 
codes for these purposes are given below; each one is singly modified. 

1050 Select Input n 

All succeeding input operations, until the next 1050 instruc- 
tion, refer to Input h. 

If no input document with number n has been defined there will 
be an exit to the monitor routine. 

If input instructions are obeyed vfithout previously selecting 
an input. Input zero is used (see Giiapter 10). 

1051 Find Selected Input 

ba' = number of currently selected input. 

This instruction is particiiLarly useful in subroutines. The 

current input may be stored at the beginning of the routine by 

1051 6 C b6' = select input. 

/mother input may then be selected raid the original one re- 
stored at the end of the subroutine by the instruction 

1050 6 Select input b6 

1060 Select Output n 

All succeeding output instructions, until the next 1060 order, 
refer to output n. 

For internal code output n is v.-ritten without an octal fraction 
(or v/ith an even octal fraction which will be disregarded). 
If binary output is required n should have an odd octal frac- 
tion (usually .1). Thus 

1060 3.1 

will select output 3 for binary output. 

If output n has not been defined there v/iU be an exit to the 
monitor routine. If output instructions are obeyed v/ithout 
previously selecting an output, output zero is used (see 
Chapter 10). 

1061 Find Selected Output 

ba' = number of ciirrently selected output plus octal fraction 

as in 1060. 

This extracode is used in a sirailar fashion to 1061. 
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^•5 Input using LI 00 

Siiioe input and output require fairJ^y complioated programs it is 
ift^e^wT"'^^^^^^ subroutines for'these pu^poEsT llO^ 

IS the Tjiput Library Routine. It will reconstruct a record and present the 
programmer with a number or a character^. It ..111 also read ^^sf 

8»5»'l Line Reconstruction 

LI 00 itself calls in L199 to reconstnin-h rv-nnwic -Pv,«r, 4.1. j._.. ^^ 

puw oape, xne record or 'line' is reconstructed as follows: "" " 

a) Each character is stored at the least significant end of a half 
word* ^^ 

b) Shifts to inner and outer sets will not be stored. Instead efvch 
simple character will be allotted seven bits. The most-signifi- 
cant bit wall be zero if the character is a member of the inner 
set and a one if it belongs to the outer set. Thus 'M' is stored 
as K5.5 and m as K15,5, 

b) The character backspace (BS) will be correctly interpreted but 
not stored. That is, characters before and after a BS will be 
combined to form a compound character (see 8.6.3), 

d) The character tabulate (TB) is not s tored. Instead the correct 
number of spaces v/HI be inserted (see 8.7.6). 

e) The last character of a line will be the carriage control char- 
accer. 

f ) The following characters have special representations instead of 
their normal internal code values:- 

Space - SP is stored as 0.0 

iu-ase - ER is stored as J4 

Paiilt - FT is stored as J3 

Underline - UL is stored as J2 

Pig-ure Shift - FS is stored as J-1 (two or more successive 

l^f^^ ^^"^"^^ ^ *^® same record are stored as a single 

line- if!f? nirJf' ^^P^!^^*^*i°^s o^cur onOy when reading a reconstructed 

:^i' "-^^^V "^ ?^^^'' ^® "^^^ internal code value is read. For e^ 

^?T C !' rf^.^W^^''^^^ character, or as a tenninatar to a number, 
will oe represented by 0.1. ^uiuuca, 

Nomally only two lines may be reconstructed in this way at one time. 
Thus only two inputs may be active at the srjne t ijne (but see 8.7.4) 

Terts are read for output using L1 j they are not line reconstructed. 
8.5.2 Entries to L100 

Several entries are provided to Li 00 to enable the programmer to read 
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nianbers or characters from the ireoonstructed linei» If numbers are read they 
will be properly translated into foiBs acceptable by the accumulator or a 
B-line. 

Por numorioal- input the character erase (ER), or any compound char- 
acter containing ER, will be ignored. For character ar^i text input ER is 
read. 

For all entries to LI 00, the link must be stored in B90, 

A list of entries is given here; further details are to be found in 
8.6, 

A1/L100 am' = next number ^ 

A2/Li00 bSI' == next integer 

A3/L100 b&l ' ==: next character 

A4/Li00 Lose the rest of the line 

AS/l^'JOO Read text to store line b89 onwards 

A6/Li00 Read text, following T newline or T/newline to store 

line b89 onward 
A7/Li00 b81 ' = next integer as a 24 bit integer 
A8/L100 b8i ' = next integer plus 3 bit octal fraction 
A9/L100 Print reconstructed line 

8,S,3 Data Preparation for L100 

The following rules must be obeyed when pimching data for Li00# 
Th3?oughout this section 

a and c are decimal integers 
b is a decimal fraction 
and k is a one digit octal fraction, 

a) A maximum line length of "160 characters plus a carriage control 
character is allowed (but see 8, 7, 5), 

b) All numbers must be punched in the form:- 

< Layout charactersxNumberx.'3?erminator> 

The layout character may consist of any combination of 

spaces , 
tabs, 

new lines, 
paper throws, 

upper and lower case shifts, 
carriage returns, 
line feeds, 
figure shifts 
or back spaces. 

No layout character ie really necessary". 
The terminator may be a 

space, 
tab. 
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new Jdjoe (or <«did of oai^d) 
carriage return followed by line feed, 
comma^ 

paper throw, 
or line feed. 

o) Numbers to be read by entries to Al/LiOO will normally take the 
form 

+_a.b 

where the *V may be omitted if desired. 

If either a or b is zero it may be omitted: if b is omitted the 

decimal point is optional. 

Example ; 

iO +7-4 31. +i67 -8. 
.17 +.5 -.761 34.61 +0.357 -26.4 

Numbers in floating point form will also be accepted by LI CO with 
this entry. These must be in the form 
+a.b(+o ) 

where o is a decimal exponent, a and b are as before; o must 
be preceded by a '+' or '-'• No spaces may occur between b and 
the character 'o' or vrithin the brackets. 



For example 

3.1 41 (+7) 

will be accepted. It has value 3.141 x 10^ 

d) For entiy at A2/L100 or A7/L100, numbers must take the fonn 

where the '+' is optional and a < 2^^ -1 for A2/L100 and 
a < 2^^ -1 for A7/L100 

Example : 

64 +731 -2 

e) For entry at A8/L100, numbers must take the form 

+ a.k 

where '+' is optional and a < 2^^ -1. If either a or k is zero 
they may be omitted; if k is omitted the octal point is optional. 

Examples: 

14 +2 -51 12. +21. -741. 
.7 +.2 -.5 61.1 +7.0 -0.4 

f ) Texts for input by entry at A5/L100 will normally be punched 
as one record ending with a carriage control character. If a 
text talces up more than one record (i.e. more than one line of 
paper tape or more than one cai'd) the characters (( must be 
pimched at the end of each record except the last. 
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g) Texts for input by entry at A6/Li00 must be preceded by 
T newline or T/newline (a warning character other than T may 
be used by the programmer)* 

h) No texts are line reconstructed. 
8.5.4 Pimohing Errors . 

a) If the routine meets an unacceptable character when searching 
for the beginning of a number, control is switched to A2i/LiOO. 
For example this v/ould happen on meeting Z in the list of integers 

121 516 -7 Z 

A21/L100 is normally a fault routine within LI 00 but can be a 
private fault routine set by the programmer (see 8, 7. 2). 
The disallov/ed character will be in B82. 

b) If the routine meets an unacceptable character in the middle of 
a number, control is switched to address A22/L100. Again, the 
programmer may set A22/L100 for private action and the disallowed 
character is in B82 as before, Swh an entry will be caused for 
example, by attempts to read a number with a fractional part by 
entiy aVwoO, (See 8.7.3) 
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8«6 The Entries to Li 00 in Detail 

ill entries apply to the currently selected input, 
8e6,1 Ai/LiOO . 

A number is assembled from the line reconstruction and is stored as 
a floating point number in M. It is rounded in the nonnal Atlas fashion 
and standairdised, and L is cleared, 

..o^+^n ^^ terminator is given in B82. If the teminator is also a carriage 
control chai^oter the most significant bit of B82 is set as one. Thus. wheT 
the last number of a line has been read, B82 will be negative. 

For example if the number is terminated by a space. b82 win equal 
JT the t enninator is new line, however, B82 will contain J4K2.1 . 

Example : 

feead ten numbers from input 2 and store them in floating 
point form in locations 40 to 49, 

''Si 3 -9 b5' = count 

■1050 2 select input 2 

5)ii0i 90 Ai/LiOO Enter LiOO to read to Am 

356 5 49 Store number 

20i i27 3 A5 Count and return, 

8,6.2 A2/LiOQ . 

. -u.^ ^ 2i-bit irrfaeger is formed from the reconstructed line and stored 

^ ^oo^° IZ ^^ °^ ^^' ^^*^ 2i to 23 are cleared. The terminator is given 
in 332 m the same way as with entry Ai/LiOO. 

Exanple '- 

Reed to the end of the line of integers on inp\ifc i and store 
them in half-words from i2.4 onv/ards. 

"•Si i bi' = count 
"^050 1 Select input i 

'"JSi 90 3* Set link 
i)i24 i 0.4 Imjrease cotait 1^ otss half- 
word 
i2i i27 A2/Li00 Head next integer to B8i 
"^''S 81 i i2.0 Store integer 
216 127 82 Ai Test for carriage control 

character 

8.6.3 AS/LI 00. 

A single character or a compound character is taken from the line 
reconstruction and stored in B81. A single (seven^bit) character goes 
into bits i7 to 23. The oharaotars ER, PT/ UL and PS will have the values 
given in 8.5.1 (but SP =. O.i ). 
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A oompound character arises from seven-hole tape input whenever two 
or three characters are punched, separated by backspaces. In the case of 
two characters, during line reconstiniotion, the numerically smaller charao- 
ter is stored in bits 17 to 25 of the half-word; the other character in bits 
10 to 16, In the case of three characters the third will be stored in bits 
5 to 9 regardless of numerical valu^, A punching sequence such as A BS A 
will be interpreted as A. Such a compound character will be read to B&l by 
the use of entry AS/LIOO. 

A Compound character may also include the underline character'. In 
this case bit one will be a 1 (i.e. J2 will be added). If a oompound char- 
acter consisting of more than three simple characters^ apart from underline 
or erase, is detected during line reconstruction then a fault is registered 
and the program suspended. Details are printed on output zero, 

For example, if the characters 

BS / BS UL 

are punched on seven-hole tape, the compound character £ will be printed by 
the flexDwriter, This will be reconstructed as follows:- 

010 000 000 010 000 001 111 

UL No 3rd character is inner 2.0 /is inner 1.7 

The instruction 

1101 90 A3/L100 
to read this character would produce 
B81' = J2K401.7 

After the last character of a line has been read, the next entry to 
A3/L100 causes B81 to be cleared. Ttie carriage control character will be 
given in B82.' 

8.6.4 A4/L100 

The routine v;ill set up the conditions necessary for line reconstruc- 
tion on the next entry to LlOOl In this way the remainder of the currently 
reconstructed line is lost. 

8.6.5 A5/L100 

Read the next record(s) from the current input and store it beginning 
at the half word whose address is given in B69. The nuftber of characters 
stored will appear in bits 1 to 23 of the half word whose address was speci- 
fied in B89. The count includes the carriage control character. The final 
contents of B89 is the address of the half vrord which immediately follows 
the stored test. (For texts of several lines see section 8,6.6}. 

Any amount of carriage control information preceding the text viH be 
treated as part of the text and stored ready for output by A6/L1 . In detail, 
upon entry to A5/IA00 all one-character records are read and stored, each 
preceded by its character count plus J4r, until a record containing more than 
one character is encountered. The latter is stored as described in the pre- 
ceding paragraph. 



( 1.65 ) 



8,6/5 

8,6.6 A6/L1 00 

This entry is to be made to read a text which appears amidst nianer- 
loal data at a point not necessarily Icnown in advance to the programmer. 
The text must be preceded by T Newline or T/Newline according as it is de- 
sired later to output the text on a new line or on the current line. (In 
fact a^y non-numerical warning character can be used in place of T). The 
text is then read in by entering A6/Li00 via the 'illegal-character-in-plaoe. 
of-a-number entry A2l/Li00 (see 8.7.2). The latter label must therefore be 
set bv the "nro^rraininfiT^ ■R'nT» o-wcmrxio -i-f* 4-v,<=. -Pn,!! ^-^^^ j-.4._ -u-j j -l,- 



A2/L100 



then the instructions 



1, 2, 3, 

TEXT 
4, 5, 6 



?1/Li00) 121 89 3: 

1362 A6/L100 
will store two records when the T is met. The first stored will consist 
of a single new line character and the second will be the entire record 
which follows the T on input. Each record is stored with its character 
count as described in 8.6.5. The count for the first record has bit 
equal to 1 as required by the entry A6/L1 to print the text. 

I^on exit from A6/L100 B89 is set to the address of the next avail- 
able half word following the stored text. 

On entry to A5/L100 or A6/L100 for a text consisting of one record, 
the next record from the system input tape will be taken and placed in the 
store beginning at the address specified in B89. This must be a fun word 
or half word address and the first half word will be used to hold a count of 
the characters in the record including the carriage control character. The 
count win be in the character position of the half-word, so for a text of 14 
characters the count win be 1.6, 

If the continuation mark (( has been used all of the records of the 
text will be read to store, beginning at location b89. Each record win be 
preceded by a half word containing a count of the characters and each of 
these half words except the last win also have bit zero set to one. The 
text win consist of all characters up to but not including the oharaatere 
( ( , and these characters must be f onowed iimnediately by new line. 

Example ; 

Suppose a text on seven-hole tape consisted of the two lines 



TAPE 12 (( 
BLOCK 3 



The instructions 



121 89 100 
1362 A6/L100 
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would set the contents of half word 100 onwards as follows :- 



(iOO) == J4JC1.1 



9 characters including 2 SP and one NL jxlus 
a continiiation nark 



8.6.7 



(100.4) = K6441604.5 TAPE 

(101) =K01 21 220.1 Sp 12 Sp 
(101.4) = J21 

(102) = Ki.O 
(102.4) =K4254574.3 

(103) =K5301 232.1 

A7/L100 



NL 

8 characters including one SP and one ND, 

BLOC 

K sp 3 IIL 



An integer is formed from the line reconstruction and stored in B81 
with its least significant digit as bit 23. The terminator is given in B82. 

8. 6. 8 A8/L100 

A 21 -bit integer with one octal digit after the point is formed from 
the line reconstruction and stored in B81. The least significant digit of 
the integer occupies bit 20 and the octal digit occupies bit 21 - 25. 

The terminator is given in B82, 

8.6.9 A9/L100 

The reconstructed line containing the last information read with L100 
is printed on the current output. For this entry, the line is taken to con- 
sist of the characters on the printed line, together vdth the carriage control 
character following it. 



( 1.65 ) 



8.7/1 

8#7 OpidjOiaal Parame'fcer s of Li 00 

Library routine Li 00 oontains seven parameters which are optionaUcsr 
set# These may he given alternative va3bues by the programmer if he ?d.shes, 
li Li 00 is oalXed for eit^^^J.oi'Uy by an L cLirecti,ve these parameters must be 
set first* This for example allows i^L to leave the right amount of space in 
the compiled program to contain Li 00. If Li 00 is called for implioitJy the 
parameters may be set at any point in the program. In this case Li 00 is 
stored somewhere after the compiled program and the exact space it will occupy 
is irrelevant at the time of the implicit setting. 

The parameters are:- 

A20/Li 00 - beginning of line r econstruction storage 
A2i/LiG0 - Routine for fault at beginning of number 
A22/Li00 - Routine for fault in the middle of a number 
A23/Li00 - Maximum number of active input streams 
A24/Li00 - Maximimi line length in characters 
A25/Li00 - Tab settings 
A26/L100 - Tab routine 

These are dealt with individually'' below. 

8.7.i A20/Li00 

The programmer may allocate specific storage for the beginning of 
line reconstruction by setting A20/L100, e.g. A20/Li00 = iOOO. If A20/L100 
is not set by the programmer A20 will follow Li 99 

8.7.2 A2i/Li00 

If during numerical input a spurious character is encountered in- 
stead of a number, control is switched to A2i/Li00 with the character in 
B82« The programmer can write his own fault routine to deal with such a sit- 
uation* This is particularly useful in dealing with a nimiber list of \inknown 
length* 

^mmple s 

Suppose the list is punched out and the terminator of the last 
nimiber is followed by the character '*' (internal code 1,6)* The 

following piece of program ?rauld read the numbers from inpxit 2 and 
foiTii their sum in A5,- If a spurious character other than * is met 
(oTOJig to mispunchijQg) control is transferred to store line AS. 



i050 








2 


Select input 2 


546 








J4 


Clear am 


4)ii0i 


90 





Ai/LiOO 


am' sa next n\iiber 


520 








AS 


am '-=3 partial sum 


356 








A5 


(A5)' = partial sim 


i2l 


i27 





A4 


Go to read next number 


5)^0 
2i/LiO0)i72 










82 





i.6 


bt' «b82 - '*' 


225 


i27 





A6 


Go to fault routined 



---«<• Next Instruotioa if not * ) 

If A2i/Li00 is not set by the programmer a stroidard fault routine 
will be entered. 
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8. 7, 3 A22/Li00 . 

If during numerical input a spurious character is encountered vdthin 
a number, control is transferred to A22/L100 with the character in B82, The 
programmer may iTrite his own fault routine to take care of this situation hut 
he will have a partially assembled number to deal with. 

If A22/L100 is not set by the programmer, a standard fault routine 
will be entered • 

8.7.4 A25/Li00 . 

The majduium number of inputs active at one time (i.e. those with a 
line reconstructed part of which remains to be iread) is nonnally two. The 
programmer can, if he V7ishes, alter this by setting A23/Li00 to the number 
he requires. Thus the directive 

A23/Li00 = 4 

would permit four streams to be active at once. This would obviously involve 
more store being used by the line reconstruction routine to accommodate the 
reconstructed lines. 

8.7.5 A24-/Li00 . 

The maximum line length accepted by Li 00 from any peripheral is 160 
characters (excluding carriage control infonaation). If the programmer wishes 
to use a different line length he must set A24-/Li00 to the nuraber of charac- 
ters he requires. 

8.7.6 A25/I/100 , 

This parameter is optionally set uithin the library?- routine to 15 
which gives the standard tab settings of 



8, 8, 8, 8, -16, 16, 16, 16 



By setting A25/L100 to -1 or 999 the programmer can arrange for tabs of 16, 
16, 16, ..... or 8, 8, S, respectively. 

8.7.7 ii^6/L100 . 

During line reconstruction a standard routine for replacing 'tab' 
by the correct number of spaces begins at location A26/L100. If the pro- 
grammer vri-shes to use a private routine to deal with tab, A26/L100 must be 
set to the starting address of this routine. Exit from the private routine 
must be to 1A28/L199. 
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8#8 Fault Printing by Li 00 

If a fault is encountered while usinc WOO, then control is trans- 
ferred to a fault routine, unless the programmer has set the appropriate 
optional parameter. The fault routine v/ill print out an indication of the 
fault, usually in the form 

< explanatory text > 
a, b, c 

< reconstructed line > 
where a is the input stream number 

b is the position of the faulty character on the line 
and is the number of characters on the line. 

It may not always be possible to completely reconstruct the line. 

The routine then ends the man of the program. 
The explanatory tex±s are listed belowi. 

IMP. CH. DURING WMBER < character > 

The character is imperriiissible within a number. 

IMP. CH. BETT/EEN NUMBERS < character > 

The character is not allowed to separate numbers 

INTEGER TOO UMrB 

The integer can not be held in the B-line. 

IMP.. COMPOUND CH. 

Impermissible compound character. 

IMP. CH. AFTER T 

Only /, erase;, or newline are allovred after T when using the text input 

entry A6/100. 

UNASSIGNED C. C. CH. 

The carriage control character is represented in the computer by a number 

greater than 5.7. 

MAX. LINS liEIlGTH JIXCEEDED 

The line length is set by A24/L100 

UNASSIGNEH) CH, 
SPME CK. 

These last two texts refer to the characters indicated in Appendix D. 

TOO MANY ACTIVE STREi\MS 

L100 has boon asked to deal, with more then the Jiumber of .input stirecimB 

set by A23/L100. No character position or line recons timet ion is printed 
out. 
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8.9 Output using L1 



L1 is the Output Library Routine and vrill output a number from the 
accumulator, an integer from a B-line, a single simple or compound character, 
or a group of characters forming a text. In actual fact this routine trans- 
fers the output inf orraation to the System Output Tape whence it is automati- 
cally sent to the required peripheral vdien output is completed. For this 
reason the single output routine can be used regardless of the output peri- 
pheral. 

8. 9, "1 Sntr;^'- points to Li . 

Different entry points are provided for each l^'pe of output required 
and the way in which numbers are to be output is specified by a style number 
in a B-line before entry to L1. 

For all entries the link is stored in B90. 

The entry points are as f ollows:- 

Ai/Li Output am in style b89 

A2/L1 Output b81 in style b88 

A5/L1 Output one character from b8i 

A4/L1 End line (or card) 

A5/Li End record by oajriage oontix)! character in B87 

A6/Li Output a text from b89 oiwards 

A7/Li Output a text from b89 onv/ards, with terminating cairiage 
control character f 2?om B87 

Further details of each entry are given belov^^. 
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8.10 The Entries to Li in Detail 

All entries apply to the currently selected output and length is limited 
only "by the oulgout peripheral. 

8.1Q..i Al/Li . 

Entry to L1 at this point causes L to be cleared and the contents of 
the accumulator to be output as a fixed or floating point number. The style 
of output is determined by the contents of B89. which must be set before en- 
try to Li "oy an order of the form 

121 89 p:q,k 

Here p is the number of decimal digits required before the point 

(0 <p < 127) 

q is the number of decimal digits required after the point 

(0 < q <15) 

and k (the octal digit) indicates the form in which the number is to be 
printed as follows :- 

k = Accumulator printed fixed point, signed, on same line 

1 Accumulator printed floating point, signed, on same line 

2 Accumulator printed fixed point, signed, on new line 

3 Accumulator printed floating point, signed, on new line 

4 Accumulator printed fixed point, unsigned, on same line 

5 Accimulator printed floating point, imsigned on same line 

6 Accumulator printed fixed point, unsigned, on new line 

7 Accumulator printed floating point, unsigned, on new line 

If k is zero, .k may be omitted. 
Further details are as follows :- 

a) All numbers will be correctly rounded to the last digit printed. 
The rounding is decimal and of the 'add 5' variety. 

b) The contents of the accumiilator will be spoiled, but the con- 
tents of B80,. B88, B89 ar& preserved. On the ether hand, B61 to 
B86 are destroyed. 

o) 'Vhen k takes the value 2, 3, 6 or 7, the current line is ter- 
minated by a single new line character before the output of the 
number. Otherwise t he number follows the last . character of the 
current line. 

i) For k = to 3 the number is printed signed, t hat is preceded by - 
SP for positive numbers or - for negative numbers (but see 8.11.2), 
With k = 4 to 7 the Sp or - are omitted altogether; for example 
both 42.5 and -2.5 would be printed 2.5, 

e) If k is odd the number is oirtput in floating point decimal form. 
The mantissa is printed with one non-zopo decimal digit before 
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the poijifc and q digits after (i.e. 1 ;^!iantissa< 10) and is fol- 
lowed by the exponent. ZeiK) in floating point forrn v/ill have 
raantissa of 0. folLowed "by o zeros and an exponent of hO, The 
number of character spaces to precede the deaimal. point is 
p+1 for signed numbers or p for unsigned numbers. 

The floating point number appears in the form 

mantissa (exponent) 

v/ith a two decimal digit exponent preceded by + or - and enclosed 
in brackets (but see 8.1-1.4 and 8,11,5. ) 

A non-significant left hand zero of the exponent will be omitted 
and a space will be output after the final character (i.e. the 
')'). If the exponent is more than tv;o digits it will be printed 
in full but layout will be spoiled (but see 8,11.4). 

f) lfk=0, 2 the number is printed in fixed point form wxth p+1 
character positions before the point and q after; if k = 4, 6 
there are jo character positions before the point and q after. 
Left hand "zeros of the integral part are replaced by spaces; 
right hand zeros of the fractional part are always printed. 
Positive numbers are printed without a sign. 

If the number has more than p places before the decimal point 
y^say P places) it will be printed either as a fixed point number 
with P places before and q after, or as a floating point number 
with (p4q) significant figures in the mantissa, whichever form 
has fewer characters. In either case layout will be spoiled. 

g) The input routine LI 00 uses index registers B88 and B89. Care 
must therefore be taken not to spoil the style set for an LI 
entry by first entering L100. 

h) The special cases of p = and q= are dealt with as follows:- 

P == 

The integral part of the number in fixed point and of the maji- 
tissa in floating point will appear as 0. Thus 0,25 output 
in style 0:2 would appear as 

sp 0.25 

while -1.25 output in s tvle 0:3.1 would be printed as 

-0.125 (+1) sp 

/m integer with no decimal point v;ill be printed. 

P= <1= 

The number is printed as spO or -0 with a decimal exponent if 
necessary. 

Examples i 

T, Print the numbers stored in locations 60 to 79 on outDut 3, 
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The niaabers shoiald "be printed signed in floating point form, eaoh 
on a new line, with four decimal places after the point. 



1060 








3 


Select output 3 


121 


1 





-19 


b1 ' - modifier 


121 


89 





1:4,3 


Style in B89 


1)324 





1 


79 


Read next no, to Am 


1362 








A1/L1 


Print a 


201 


127 


1 


A1 


Coiint and return 



Ifext Instruction 

2, Read the next number from input 2 and prdnt it on output 1 on the 
current line. The number should be fixed point, unsigned with four 
places before and two places after the decimal point. 



1050 








2 


Select input 2 


121 


90 





2* 


Set link 


121 


127 





ai/lioo 


Read one number 


1060 








1 


Select outpirb 1 


121 


90 





3* 


Set link 


121 


89 





4:2.4 


Set stjle 


121 


127 





A1/L1 


Print ramber 



- - - - Next Instruction 

8,10.2 A2/L1 . 

Entry to A2/L1 causes a 21 or 24 bit integer from B81 to b e printed. 
The style of output is determined by the contents of B88 which must be set 
before entry to LI by an order of iiie form 

121 88 p:ci.k 

Signed integers are printed with p+1 character positions before the 
point, if any (see b) below), and unsigned integers \7ith ^ character posi- 
tions before the point, if ajny. Left hand zeros of the integer ore replaced 
by spaces. Positive signed integers are preceded by a space rather than a 
plus sign I to print something other than a space, see u, il.^y. 

k is interpreted as for accxmiulator output except that the distinc- 
tion between fixed and floating point numbers is replaced by that between 
21-and 24-l)it integers. Thus the interpretation of k is as follows:- 

k = b81 is printed as a 21-bit integer, signed, on same line 

1 b81 is printed as 24-bit integer, signed, on same line 

2 b8l is printed as a 21 -bit integer, signed, on new line 
- 3 b81 is printed as a 24-bit integer, signed, on new line 

k= 4 b81 is printed as a 21 -bit integer, unsigned, on same line 

5 b81 is printed as a 24-bit integer, unsigned, on same line 

6 b81 is printed as a 21 -bit integer, unsigned, on new line 

7 b81 is printed as a 24-bit integer, unsigned, on new line 

Further details are:- 

a) The contents of the accumulator ani of B81 are spoiled, but the 
contents of B87, B88 and B89 are preserved, B80 is not used 
but B82-86 are overvirritten. 
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b) If k is even b&l is ti^ated as a 2i-bit integer. If q=s 0, bits 
to 20 are taken as a pure integer and bits 2i to 23 are ig- 
nored* If q takes a^jr non-zero value the integer is follov/ed 
by a point and one octal digit taken from bits 21 to 23, 

o) If k is odd b81 is printed as a 24 bit integer. The value of q 
is irrelevant. 

d) If the integer has more than p digits it will be printed cor- 
rectly but layout will be spoiled. 

Example ; 

t'rint the nxanber 97 on a new line on output 1 followed by the 
contenos of store half-word 97 as a 21 -bit integer with octal frac- 
tion. Allow for six characters before the octal point of the in- 
teger. 

Call 

Style in B88 

b81 ' = 97 

Print '97' 

Style in B88 

b81' = (97) 

Print (97) 



Entry at this point will cause one character, which may be simple 
or compound, to be printed from B81. Simple characters must be placed in 
the least significant six bits of B81 with bit 17 indicating whether the 
character is inner or outer set as 8.6.3. 

An alternative way of printing an outer set character is by output 
of the 'shift to Outer Set' character, K0.4. All succeeding characters are 
then specified by six bits only and v/ill be printed as outer set characters 
until the 'shift to Inner Set' character, K0.5 is encountered or the end of 
the record is reached. Thus to pidnt outer set characters from the next 
record a further 'shift to Outer Set' character must be output;. 

Compound characters may also be built up in B81 as described in 
8,6.3. Entry at A3/L1 will unpack each character and output them separated 
by backspaces. (Q?his facility can be employed only if output is t o 7-hole 
paper tape since this is the •nly output medium with a BS character). Under- 
line characters are allowed in the same way as shown in 8.6,3. 

The characters ER, "FT, -UL and PS may take either the f orms adopted 
by L100 (i.e. ^4, J3, J2 andJI) or their internal code numbers (K17.7, K7.7, 
K12.6 and K0.7). The fault character, which normally arises only from in- 
put via LI 00, is output as erase underlined. The actual printing of the 
fault character on the different peripherals is as follows (see 8.2). 

7-track ER 

5-track M ER ER 

Anelex .. — 

Cards •• — 







1060 








1 






121 


88 





2:0.6 






121 


81 





97 






1362 








A2/L1 






121 


88 





5:1.0 






101 


&1 





97 






1362 








A2/L1 


8.10.5 


A3/L1 . 
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i\ll oompound oharactera containing J4 (i#o« vdlth bit zero set to 
one) will be output as erases. If an attempt is made to print an impossible 
character (e.g. (Jon 5-hole) a full stop will be printed instead. 

Example ♦ 

ir'rint, on the cui-rent line of output 6, which is a seven hole 
paper tape punch, the characters 



12-1 


81 





K4,i 


bSI ' = "A" 


1562 








A3/L1 


Puiah A 


121 


31 





K14,2 


b8l' « 'b' 


1362 








A3/L1 


Punch b 


121 


81 





K0.1 


b81' = 'SP' 


1S62 








A3/L1 


Punch SP 


121 


81 





J2K401,7 


b8l' =£ 

Punch /l»S BS UL 



While entry AS/l is useful for the output of compound characters, it is more 
efficient to use the extracode 1064 to output single characters (see 8,15). 

8*10.4 A4/ L1 

With this entry, the current line of output is terminated by a single 
new line (or end-of-card) character. The extraoode 1065 2.1 has 
exactly the same effect and should normally be used, 

8.10.5 A5/L1 

If more than one new line character, or some other carriage contixd 
output is required, entry may be made to i\5/Ll, B87 must contain the car- 
riage control information as detailed in 8.3, 

Sxaaple; 

For six new lines the necessary instructions are 

121 87 K2.6 
1562 A5/L1 

The extracode 1065 87 has the same effect, and should nonnally 
be used. 

8.10.6 A6/L1 

Entry to A6/L1 will output a text from store locations beginning at 
b89. The text must be stored in the form in which texts, are read by LI 00, 
(see 8.6.6). That is 

a) each record of the text must be preceded by a half word con- 
taining a count of the number of characters in the record in- 
cluding the carriage control oliaracter. 

b) for each record except the last this half word must also have 
bit zero set to one (i.e. for n characters, the half word must 
contain YnJ4). 
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o) characters must be six-bit, internal code, and must be paxsked 
eight to the word. 

Example ; 

The text stored by Li 00 in the example at the end of para- 
graph 8,6,6 could be printed on output 4 by the instructions :- 

1060 4 Select output 4 
121 89 100 b89' = 100 
1362 A6/L1 Print text, 

8.10.7 A7/L1 

Entry to AT/lI will cause the output of a text in the sane way as 
entry to A6/L1 except that the carriage c onfcrol character terminating the 
(last) record of the text is replaced by a carriage control character spec- 
ified before entry in B87, 

In particular, if further information is to follow on the same line 
as the last line of the text, entry should be to A7/L1 with B87 zero. The 
last line of text will not then be terminated. 
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8,1i Optional Parameters of Li 

As with L100, several optionally set parameters are contained within 
Li which may be reset by the progranuner if he wishes!. They are:- 

A2i/Li mask for p 

A22/Li mask for q 

A25/Li 'sign' for positive number from accumulator 

A26/Li 'sign' for positive number from E8i 

A27/Li • number of characters of floating point exponent 

AoQ/T«i X n'tnr.^.mr^n-i-cfr*'^ V>^-P/^-»*Q. nv\A eT'4-<ir» -f^ rvq-f-.-i Ticp Tvrn tit: 

A29/Li } exponent. 

Details are given below, 

8.1i,i A2i/Li^ A22/Li 

p and q are normally taken modulo i28 and i6 respectively, and this 
is sufficient for most users. However, it is possible to change these values 
(which must be powers of 2) by setting suitable masks in A2i and A22. Thus 
directives 

A2i/Li = 255: 

A22/Li = 63 

would cause p to be taken modulo 256, and q modulo 64. The maximum values 
of p and q are 2048 and 5i2 respectively, 

8,ii.2 A25/Li 

As stated in 8.i0,i and &,iO,2 positive signed numbers are normally 
preceded by a space in place of a sign. If it is required to output some 
other ch^mcter jjistead, usually a ' +' character, A25/Li should be set to 
the internal code value of the character required. 

Thus, 

A25/Li == K5-5 
will produce plus signs before positive niMbers, including integers, 

8.ii.5 A26/Li 

In a similar fashion, parameters may "be set to the internal value 
of a character to be printed before positive signed numbers from B8i. It is 
optionally set to KO.i (SP) within the library routine. 

S.ii,4 A27/Li 

The standard fora of the exponent of a floating point number, out- 
put by entiy Ai/Li lias five characters consisting of brackets, a sign and 
two decimal digits. This may be altered by the programmer to the total 
number of characters required, say 

A27/Li = 7 

If the exponent has less than A27/Li-3 decimal digits, enough spaces 
will be output after the final bracket to make up the difference. For example 
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with seven characters, a.n exponent of 3 would be printed 

(45) SP SP SP. 

S.-li.S A28/L1 and A29/Li 

xliese parameters are set to the internal values of the characters 
before and after the exponent for floating point output. If not set by the 
programmer they will have the values Ki.O and Ki .1 respectively to produce 
'(' and ')'. F ^ ^ 

Should the programmer wish for other characters in these positions 
he may reset A2S/L1 and A29/Li. 

Thus with 

A27/L1 = 5 

A28/L1 = K-1.2 (comma) 

and A29/L-1 « KO.i (space) 

17 

The floating point number 3.16 x 10 will be output as 

SP 3.16,+17 SP 
instead of the normal 

SP 3,16('+17^ 

If the last character is to be omitted completely, A29/L1 may be 
set to zero. 
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8.12 Input and Output by Eyfcraoode 

Although suffioient for most puirposes, L100 and LI do not oope with 
the input requirements of all programs. In particular they cannot deal with 
paper tapes or cards punched in a non-standard code (i.e. binary input or 
output). To deal with such cases the input and output extracodes are pro- 
vided. 

These extracodes read six-bit characters from the records of the 
System Input Tape ond write characters to the System Output Tape in pre- 
paration for punching or printing. Since information on the Input Tape is 
in records, provision is made for reading either single characters, groups 
of characters, or complete records. Output may be formed in similar units. 

It is important to note that when L100 is used to read input it 
takes a complete record from the System Input Tape and reconstructs it be- 
fore presenting the programmer with a character, a number or a text. Per 
"Uiis reason -tiie library routine and the input extracodes can not be used to 
work on the same input record. Output records may, however, be budJ.t partly 
by LI and partly by extracodes. 

The lack of line reconstruction also makes compound characters im- 
possible with extracode input. Thus a seven-hole tape character may be al- 
tered or erased by another character, later in the record. For example, 
suppose a data tape contained the sequence of characters: 

b BS ER a 

By reading with LI 00, the first three characters would be combined to form 
a compound character and, since it contained erase, this character would be 
ignored. An entry at A3/L100 to 'read next character' would -ttius produce 
the character 'a'. Using an extracode to 'read next character' instead 
would produce 'b'. Such effects as this must be taken into account by the 
programmer. 
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8.1 V 

8.13 Binary Input and Output 

Input and output extraoodes may work with either the 12-bit binary 
characters described in 8.1 .4 or 6-bit internal code characters. 

On input from punched tape, data documents are read and stored in 
internal code until one of the markers ***B, ***F or ***E is encountered. 
These markers are stored. Subsequent2o'" a direct binary representation 
of the input characters is stored as 12-bit characters on the System Input 
Tape. Any card with a non-standard code punched in its first column will 
also be stored as binary input. Definitions of the binary markers are given 
in the chapter on Job Documents. 

Seven track input is checked for odd parity when reading binary in- 
put and the tape is rejected if an even parity character is enoounterei. 
However, if ** P precedes the binary markers ***B, etc., then even parity 
characters will be accepted and stored as for odd parity characters. 

Binary information for five or seven track tape is stored with the 
three hole side of the punching in the least significant position. Thus the 
letter M if read in binary from seven track tape would be stored as 

000 001 Oil . 101 

or if read from five track tape, as 

r»AA AAA A<l A ■ JIJA 
\JKJ\J UW VIU . I lU 

The . indicates the position of the sprocket hole on the tape. 

On binary input a punched card is represented by 80 twelve bit char- 
acters followed by one six bit zero carriage control character. Each column 
is stored as a 12-bit binary character with the top bit of the column stored 
as the most significant bit and the bottom bit as the least significant. 
Thus one column of a standard ICT punched card is stored as 

1£11 ° 11 ^ ^ ^ ^ 7 8 9 

For output, as described in section 8.4 the least significant bit of 
the 1060 extracod© determines whether output is in internal code or binary. 

All binary information, whether input or output is stored as one re- 
cord with a 0.0 carriage control character. A carriage control character 
erioountered within a section of binary input will be treated as a normal 
binary character. Thus NL, represented on seven-hole tape by 

0000.010 

will be stored on the System Input Tape as the 12-bit character 

000 000 000 010 

Binary input may be used to read tapes or cards punched in non-stan- 
daid. code, since the programmer can provide his own translation routine for 
the binary representation. Similarly he can cause his results to be punched 
in a non-standard form by these means. 
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^•''^ The Input Ertraoodes 

The Select Extracodes have been described in section 8«4. The remain- 
ing input extracodes are defined below. Each is singly modified and refers 
to the currently selected input. 

1052 Find Input Device Number 

ba' = V-store address of the periphercil equipment used for the 

currently selected input. 

If txiis input originated as output from another program, 

ba' == 0. 

For input from 5- track tape the least significant bit of ba' 

(i.e. bit 23) is 1 ; otherwise it is 0. The V-store addresses 

are described in appendix C» 

"JOSS Test Binary / Internal Code 

If the next character to be revA from the currently selected 
input stream is a binary character, ba' == n. 
if the next character is in internal code, ba is unaltered. 
If there are no characters remaining on the currently selected 
input stream, an exit is made to the monitor routine. 

'"^^'^ S-ead next character to Ba / Jump to n at end of Record 

This extracode reads the next 6-bit character from the currently 
selected input, and places it at the least significant end of 
ba. \i'±th. internal code input this will transfer one internal 
code character. With binary input, where the information is 
stored in 12-bit characters, the first use of the extracode will 
read the six most significant bits of the binary character. 
The next use of the extracode -iirill read the six least signifi- 
cant bits. Normally control -vvill then pass to the next instinic- 
tion (i.e. b127' =b127+1) but if the last character, apart 
xrom the camage oontroo. charaetsr, nas prevjuousxy ueen reau.^ 
b127' = n and Ba contains the carriage control character in 
bits 18 to 23. 

If all characters of the currently selected input stream have 
been read, this extracode causes an exit to the monitor routine. 

1055 ba' = Number cf Blocks Read 

This sets in Ba the number of 512 word blocks read from the 
selected input. In internal code each block holds 4,096 char- 
acters, but some of these are carriage 'oontrol characters and 
record counts used on the Sij'-stem Ii^ut Tape. In binary code, 
one block holds 2,048 twolve-bit characters. 

1056 Read bg characters to S 

Before using this extracode the number of 6-bit characters re- 
quired must be set in the character position of ba. For exam- 
ple, for 18 characters ba must be set to 18D3 or 2.2. The ex- 
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tracode vfill then read the next ba cheiracters from the current 

record of the selected input and place then in Store locations 

beginning at the half-word address S. Four six-bit characters 

are packed in each half-v.-oixi. Bits 22 and 23 of S and bit of 

ba are ignored. 

If the end of the recorni is net reached, ba is unaltered on 

exit except for bit which is set equal to one. 

If the end of the record is reached no further characters are 

read and Ba contains the number of characters read in bits 1 to 

23. Bit is set to zero. The last character read will be the 

carriage control character. 

If all the characters in the currently selected input stream 

have already been read, ih±s extraoode causes an exit to the 

monitor routine, 

1057 Read next record to S 

This extracode reads the next record and places it in the store 
starting at the hGlf-v702?d address specified in S. Characters 
will be packed, four six-bit characters to the half-word and bits 
22 and 23 of S will be ignored. The last character will be the 
carriage control character. 

On exit Ba contains in bits 1 to 23 the number of 6-bit charac- 
ters read and bit is ze3?o. 

If the record has been partly read, by use of 1054 or 1056. the 
renairjLng part of the record is read. 

If all records of the currently selected input have been read, 
this extracode vdll cause exit to the monitor routine. 

Extracodes 1056 and 1057 will run very much faster if no characters 
have previously been read from the record, or if the number which has been 
previously read is a multiple of four. Both these extracodes use fbz" fewer 
instr'-ctions per character than does 1054, and are therefore much superior 
for large amounts of input. 

Examples : 

Tl Input stream 3 consists of one record in internal code followed 

by a binary marker. Neglect this record and read all the binary infor- 
mation after the marker to store locations 1000.4 onwards, packing the 
12-bit characters fovoc to a word. Place the number of 12-bit charac- 
ters in half-word 1000. 

1050 3 Select input 3 

1057 1 1000.4 Read internal code record 

1057 1 1000.4 Read binary record 

"124 1 1 Convert character count 

■124 1 1 To binary character count 

113 1 1000 Store character count 

2. a) HqcA the six-bit characters from input strear:i five and store 
them at the bottom of separate half-words beginning at location A5 
until a binary record is encountered. All carriage control characters 
are to be ignored and the address of the last stored character is to 
be left in B1 . 
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b) Store the first 12-bit binaiy character at the least signifi- 

cant end of the -half-word A6 (assume that at least one such 12-bit 
character exists). 



121 


1 





0.4 


nodifier :^ 0.4 


1050 








5 


Select input 5 


1)1053 


127 





A2 


Go to A2 if next character is 
' binary 


1054 


60 





-1* 


■)Read next oh. to B60 
;Check next record if cairiage 


















cont. char- 


113 


60 


1 


-0.4A5 


Store character 


200 


127 


1 


A1 


Go to A1 and add 0.4 to b1 


2)124 


1 





-1A5 


b1 ' = last address 


1054 


60 








Read m.s. half of binary 
character (n is not used) 


125 


60 








Shift b60 up 6 binary 
places 


113 


60 





A6 


Store la.s. half 


1054 


60 








Read l.s. half* 


114 


60 





A6 


Store l.s. half 



- - - - Next Instruction 

3. Read the renainder of the current record of input 2 into 

locations beginning at 105.4 and place after it, beginning at the 
next available half v/ord, the same nuraber of characters f rom the 
succeeding record. Assume that the succeeding record oojatajjoa at 
least as many characters as the current one. 

1050 2 

1057 20 105.4 

1056 20 20 105o7 
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e.15 The Output Extracodes 

The necessary extracodes for selecting output streams have b eon 
described in section 8,4. As with input orders each outxjut extraoode listed 
below is singly modified and each refers to the currently selected output, 

1062 Find Output Device Type 

ba' = V-store address of the peripheral equipment used for 

the currently selected output. 

If this outnut is to any peripheral (see Job Descriptions. 

Cb-pter -10) ^ f 

th'.n ba' = 

Tne V-store addresses are given in appendix C, 

1064 Write Character n 

This extraoode writes the character occupying the six least 
significant bits of the address to the currently selected out- 
put. If the internal code mode has been selected one internal 
code character will be written. If output is in binaiy mode, 
the extraoode must be used twice to write the ni.s. and l,s. 
halves of each 1 2-bit character respectively. 

1 065 End this Output Record 

This writes the carriage control character occupying the six 
least significant address bits to the currently selected out- 
put, and terminates the record. In binaiy output it is usual 
to write a zero carriage control character, but in fact the 
carriage control character is neglected at time of printing 
or punching and any character would do. 

1066 Write ba characters from S 

Before entry to this extraoode ba must be set as follows: 

in bits 1 to 23:- a character count as with 1056 
in bit 0:- if the record is to be ended 

1 if the record is not to be ended 

If the record is to be ended the last character is taken as a 
carriage control character. 

The extraoode vrill when vn?ite the ba characters beginning at 
store address S to the currently selected output. The charac- 
ters must be packed, four six-bit characters to the half-word. 
The least sigmi'icant tT/o bits of S are ignored (i.e. S must 
be a half-word or full-vrard address) 

1067 Write a Record of ba characters from S 

The effect of this extraoode is exactly the same as using 
1066 with bit of ba equal to zero'. 

Before entry Ba must contain the character count in bits 1 to 
23. Bit of ba will be ignored as \d.ll bits 22 to 23 of S, 
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The extracode will write a record of ba 6-bit characters from 
store locations beginning at S. 

The characters must be packed four to the half-word ojd the 
last will be taken as a carriage control character, 

Extracode s 1066 and 1067 run very much faster if no characters have 
previously been sent to the record or if the number of characters previously 
sent is a multiple of four. Both these extracodes use far fewer instructions 
per character than 1 064 and are to be preferred for large amounts of output. 

Examples; 

1, Read an internal code record from input one and send it to 
output three. 

1050 1 Select input 1 
1060 3 Select output 3 

1057 1 100 Read record to locations 

100 onwarxi 

b1 ' = count of characters 
1067 1 100 Output the record 

2. Write the character stored in B2 to output two and follow 
it by the six characters in store locations 10.4 to 11.1. End the 
record with the oairriage control character in 11.2. 



1060 








2 


Select output 2 


1064 





2 





Output oh. in B2 


121 


21 





0.7 


Count of characters in B21 


1066 


21 





10.4 


Output record 



3. Output the following items on sti^am three, which is a 
seven-hole tape punch. 

a) The characters BI. 

f) Tliree new lines. 

o) The 39 twelve bit characters which are stoi^ in packed 

form, from location A12 onwards, 
d) The binary character 0011.010 

Then end the binary record. 



a) 


1060 

1064 
1064 














3 

4.2 
5.1 


Select output 3 for internal 
characters 
Output B 
Output I 


t) 


1065 








2.3 


End record with SN.L's 


0) 


1060 
121 

1066 



60 

60 









3.1 
59D2 

A12 


Select 3 for binary 

Set count for 78 six-bit 

characters 

Output binary ch's 


i) 


1064 











Output m.s. half 
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1064 K5»2 Output l.s half 

1065 End binary record 

The following extracodes do not apply to the currently selected outptitJ, 
1063 Delete Output n 

This deletes any information previously sent to Output n, and 
prevents it being printed, provided it has not been printed 
already by use of a 1071 extraoode (see below). 

1070 Rename Output n as Input Ba 

This enables information sent to Output n to be read back by 
the same program as input. For example 

1070 3 2 

will rename output 2 as input 3, 

1071 Break Output n 

Normally, as described in chapter 10, all output is stored 
until the running of the program is completed. Then each 
output stream is put out separately preceded by the heading 

OUTPUT n 

and the title of the job. 

This extraoode indicates that the information so far recorded 
on Output n may, if convenient to the Supervisor, be treated 
as separate from any subsequent information sent to that out- 
put. The Supervisor will then arrange to send all information 
before the Break to the peripheral and output it with a heading 
and Job title. Subsequent output will be stored in the usual 
way and output after the job is complete, 

1072 Define Output n 

Normally output documents should be defined in the job des- 
cription in the manner given in Chapter iO. They may alter- 
natively be defined by using this extraoode. Before obeying 
this instruction, ba must be set equsO. to the maximum number 
of blocks of 4,096 six-bit characters to be allowed on Output 
n and ba* must define the output device to be used in the code 
described in appendix C, 

Example ; 

To define a ca2?d punch output with number six to 
which a maximum of 2 blocks will be sent, the following 
instjTuctions are required: - 

121 25 2 Set B25 for 2 blocks 
121 26 J600422 Set B26 for cards 
1072 25 6 Define output 6 
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3.16 Further Information on binary input/output 

'kVhen using Atlas Internal Code an SO-colimin punched card is rep- 
resented by 80 six-bit characters and a next-card carriage control char- 
acter, i^e, K2,1. Thus, to punch all 80 columns using extraoodes 1066 or 
1067 it is necessary to specify 81 characters in Ba by an instnwtion of the 
type 

121 Ba 81D3 

1^ ii Hi )i I ri. 1 a. » uu jl (j;ei,wL &, Wcii\i, Wv CA,l»A"tiijWU.C iWWW- Ucl ?> f m n in wof^A T i %r Stq 

least 81 characters. 

In binary a punched card is represented by 80 twelve-bit characters, 
one for each column, and one six-bit character with the value O.O, 

If more than 80 (internal code or binary) characters are output to 
a card, the first 80 of them will be punched on one card and the remainder 
on the next card starting again with column one, A continuous stream of 
characters output to cards with no carriage control information would accor- 
dingly be printed 'punched tape fashion' on successive cards. 

The punching *** is not recognized on cards. Instead a card is in- 
serted whose first column is punched 7, 8 and whose last column is punched 
Z, T, B, etc. The inteiTvening 78 colimms can contain anything whatsoever. 

'wTien a binary tape (but not a deck of cards) is read to its physical 
end (B or F) the final half word of the stored input is overvnritten with 
J07070707. -^his means that the last one or tv/o tape characters are stored 
as 000111000111, The zero carriage control character is unaffected. 

On tape following ***E the warning characters '•'**C or ***Z are them- 
selves stored in binaiy. They are not subsequently overwritten and each is 
followed immediately by the zero carriage control character. On cards fol- 
lowing 7,8E the terminating card bearing 7,8C or Z is also stored. On tape 
and cards the new docxjment which follows a C marker is automatically read in 
Atlas Internal Code; fuirthermore, if on seven-track tape, the document will 
be parity checked, even if ***p headed the previous document. 
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Chapter 9 
l>iAGNBTIC TAPE 

9.1 Introduction 

For many pxnrposes, a magnetic tape can bo regarded as a larger but slower 
form of main store, but it is subject to the restriction that it must be 
scanned sequentially. It can perhaps best be likened to a notebook vtio^ 
pages must be turned slowly one at a time: it is possible to ignore a page 
but it is still necessary to turn it over, and this takes as long as reading 
it. Fnen using magnetic tape, it is therefore necessary to ensure that the 
information on the tape is arranged in the order in which it will be required. 

Atlas uses two types of magnetic tape, of one and of half inch widths. 
The system tapes, and most tapes for private use, ore one inch wide, pre- 
addressed tapes, which may be used for fixed or variable length transfers. 
Reading from the tape is possible in both forward and backward directions. 
The half inch tape is not preaddressed, and can only be read forwards: trans- 
fers £ire all variable length* One inch topes prepared on the I.C.T. Orion 
computer may also be read. 

To make efficient use of magnetic tape, it is necessary to overlap 
magnetic tape transfers and computing as for as possible. This requires 
care in the timing of transfers and the allocation of storage space when 
direct transfers to tape are employed. The programmer is, however, relieved 
of this responsibility when using the extraoodes for variable length tape 
transfers, because these interpose a buffer store betr/een the program and 
the tape. 

Within a program, each mapietic tape is identified by a mmiber. Thia 
number, B, is nonnally written in the Ba digits of an instruction and lies in 
the range < B < 99, The tape number, B, is nonnally allocated to the ap- 
propriate tape by the Job Description, which will be described in Chapter 10. 
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9,2 Atlas One Inch Taye 

Information on each magnetic tape is split up into sections of 512 
words. There are 5000 sections on each fiill- length magnetic tape, and these 
are numbered from at the beginning of the tape to 4999 at the end. Section 
is reserved for special purposes, and when a tape is first mounted it is 
positioned ready to move forwards and use section i« Normally a program will 
first use the tape starting at section 1 , Later it may require to return to 
section 1 or go on to some other section, and it must then obey a search in- 
struction. The instruction 

iOOi Ba n 

will search for the beginning of section n on tape number Ba prior to fixed 
length transfers. Thus, to search for section C «n tape 4, we would write 

1001 4 8 

The 1044 extracode must be used for a search before variable length 
transfers (see below). 

Searching tape is a relatively slow process compared v/ith the compu- 
ting speed of Atlas, and the time talcen is proportional to the number of 
sections traversed. Therefore the information on tape should normally be 
stored in consecutive sections starting at section 1, and any search in- 

o4-T«Ti/%-l-T i-vv\o oVi/iTiTr? Vi^ ,-»-? tr^-^ ^ ^ « -.^T -. _^ :t,t_ J— a.1. _ _. 

^ w- ^« wj-wiivj wj.j.wu(_uu. wo 5 J.VCA1 <3.o ceu-a-ly ti£> puasj-uxc J.xi uxie pX"Ogx*am. 

In this chapter it will sometimes be necessar;^^ to refer to "blocks" 
of store. On Atlas, a block is a unit comprising 512 vrai^ds of main store; 
block number P contains the 512 wo2?ds vj-hose addresses are 512P to 512P + 511. 
The store structure will be explained in chapter 12 but this simple definition 
should sui'*fice for the present. 

All magnetic tape instructions are singly modified, and throughout 
this chapter references to the address of an instruction apply to the modi- 
fied address N + bm. The tape number is normallj^ written in the Ba digits, 
but if Ba = 1 22 the tape number is specified by b1 21 , 



( 1.65 ) 



9.3/i 

9,3 Block Transfers on One Inch Tape 

Block transfer instructions allow a program to transfer 51 2-word 
"blocks of information between a magnetic tape and a specified block of store. 
To obtain maximum efficiency in using magnetic tape, a p2?ogram should use 
these block transfer instructions and make its own provision for the overlap 
of tape transfers and computing, 

Q-.^^'l T^lnriV— 'T'r»a'n.c:f"(sr« Tno+r*n/^+"ir>na 



The section search instruction, "1 001, described in section 9.2, may 
be used to position the tape before block transfer operations. An instruction 
of the form 

100 2 Ba P: 

would then read the next 512-word section from tape Ba into block ?• 

In the block transfer instructions, the octal fraction of the address 
is used as a parameter K, < K < 7, where K + 1 specaJfies the number of 
blocks involved in the transfer. Thus, to read the next two sections from 
tape 4 into blocks 5 and 6, v/e would write 

1002 4 5:0.1 

The block transfer instructions are as follows :- 

1001 Search for the beginning of section n on tape number Bat 

1002 Read the next K + 1 sections from tape Ba into store blocks 
P, P +1, ..., P +K. 

1003 Read the previous K * 1 sections from tape Ba into store 
blocks P + K, •.,, P +1, P. 

1004 Write sto2?e blocks P, P +1, ..,, P + K on to the next K + 1 
sections of tape Ba* 

1006 I.Iove tape Ba backvvards K +1 sections. 

v/hen reading either forv/ard or baciaTard, information will be held in 
store in the same order as on tape, with tlie first word In the lowest num- 
bered tape section transferred to the start of the store block v/ith the 
smallest address. This order of words is also maintained when writing to 
tape. 

Examples ; 

1. Read section 19 of tape 3 to nain store block 6, 

(a) 1001 3 19 Search for section 19 

1002 3 6: Read forward to block 6 

(b) 1001 3 20 Search for section 20 

1003 3 6: Read backward to block 6 
The information in block 6 v/ill be the saiae in either case. 
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-1006 


66 





0.2 


121 


1 





4: 


1006 


66 








1003 


66 


1 


20: 


123 


1 





1: 


216 


127 


1 


A1 



9.3/2 

2. Read sections 1, 3, 5, 7 and 9 of tape 66 into main store blocks 
20 to 24 inclusive. The previous operation on tape 66 was to 
write to section 13. 

Position tape after section 11 

Set block modifier 

1) 1006 66 Move t ape back 1 section 

Re£id previous section 

Reduce block modifier 

Return if non-negative 

A considerable saving is obtained in this example by reading 
backwards. To have searched for section 1 and read forwards would 
have meant traversing nine sections twice and would have taken al- 
most twice as long. 

The instructions have been arranged so that the 1006 ihstruction 
comes before the 1003 instruction in the loop. If the 1003 instruc- 
tion had been put first, the program would have traversed one extra 
section after the last read instruction j in this particular program 
the extra section would have been section and the program would 

«..-w of section is ■'^rohibiteds 

9. 3. 2 Use of Block Transfers . 

The way in which a program uses magnetic tape irill depend veiy much 
on the requirements of the process it is performing. Sometimes it is neces- 
sary to read a large amount of infonnation, such as a coraplete matrix, before 
computing can coiiimence. In this case, shortage of store may prevent the over- 
lap of computing with further tape reading, but at least the next required 
tape address can be searched for; afterwards it may be possible to overlap 
the writing of the results to one tape with the reading of the next set of 
data fror.1 another. The technique of branching, to be described in chapter 
12, ma^'' also help in this situation. 

WTien it is possible to work sequentially through the information on 
tape, operating on one word or one small group of words at a time, consider^ 
able savings can be made by overlapping tape transfers vvith computing. This 
is done automatically by the variable length transfers (see below). With 
block transfers, overlap can be obtained by transferring alternately to tv;o 
different blocks, computing on one v/hilst transferring to the other. 

The same process can be used v/hen operating on two or more magnetic 
tapes. When processing longer items, special care is needed if an item over- 
laps two tape sections. 

Example: 

To read sections 1 to 2000 of tape 4, presenting each woi^i 
to a processing routine R3, a control program of the following form 
would suffice: 
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9.S/S 



2) 



EO 


ASSUMED 






1001 


4 





1 


Seaixjh for section 1 


1002 


4 





6:0,1 


iLead to blocks 5 aiid 6 


121 


71 





511 


Set word count 


121 


72 





1999 


Set section count 


121 


127 





A4 


Jump to label 4 


124 


2 





1 


Step up address 


203 


127 


71 


Al/3 


Count words in block 


121 


71 





511 


Reset v;ord count 


203 


127 


72 


*2 


Count tape section 


121 


127 





A5 


'R-xit 


1002 


4 


2 


-1: 


Read to refill block just emptied 


203 


127 


73 


A1/3 


Count blocks 


121 


73 





1 


Set block count 


121 


2 





5: 


Set first block address 


R3 










324 





2 





Read v/ord 


• 
♦ 




• 
• 


• 
• 


Process word 



4) 



1) 



121 127 A2/0 Ret-orn to RO for next ;7ord 

In the preceding example, because it is reading two sections in ad- 
vance, the prograiii reads one section more than it requires, but does not 
attempt to process the extra section. This extra read operation could be 
avoided by an extra test in the example, but it would be unavoidable if the 
end of the process were detected by the processing routine on receipt of the 
last word. There is normally no harra in reading extra sections provided that 
they do not lie outside the range 1 to 4999 inclusive, and provided that these 
^^^'^^^.^^^'^^°^^ ^^'^^ ^^^^ ^•'^i'^'ben to since the t ape was last addressed. It, is 
therefore advisable to write a few extra sections after the information when 
a tape is vrritten to. A magnetic tape fault (512-;TOrd fault) will show up if 
an attempt is made to read from a section r^ot previously written to. 
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9.4 Variable Iiength Working on One Inch Tape 

To simplify the writing of some magnetic tape programs, extraoodes 
are provided which execute the transfer of variable length records between ' 
magnetic tape and the main store. Variable length operations must initially 
be preceded by the variable length word search. The instruction 

1044 Ba S 

will search tape number Ba for the section and word contained in the full 
word with address S, Tiie section number is contained in the more signifi- 
cant, and the word niimber in the less significant half word, both being held 
as 21 bit integers. Thus, to search for the eighth vrord of section 10 on 
tape 4, we would write 

1) H10 8 

1044 4 A1 

The 1001 search may not be used with variable length v^orking. 

The extraoodes for variable length operations require an area of 
store to be used as a "buffer", to hold infonnation in transit between th« 
tape and the store. This buffer must be set up, and the mode of operation 
specified, by obeying a "start" extracode for each tape involved in variable 
length operations. Thereafter, a "transfer" exbracode is used to transfer 
information between the buffer and the program as required. \Vhen writing to 
tape each such transfer forms one "record" on the tape. 

Before writing variable length records to magnetic tape, it is neces- 
sary to obey a 1032 instruction. This "start writing" instruction normallly 
takes the form: 

1032 Ba P:0.K 

This prepares for v/riting forwards starting at the next vrord on tape Ba, 
and selects it for variable length operations. It also sets up a biiffer 
store in blocks P to P + K inclusive; normaUy K =: 1 , allowing a two block 
buffer. Thus, to start writing variable length records to tape 5, using 
main store blocks 10 and 11 (locations 5120 to 6143) as buffer, v/e would write 

1032 5 10:0.1 

Thereafter, information may be transferred to tape 5 by 1040 instruc- 
tions. Before obeying a 1040 instruction, when writiiig to tape, the number 
of words to be transferred and the end-of -record marker must be set in an 
index register: the number in the integral part and the marker in the octal 
fraction. This index register must then be specified in the Ba digits of the 
1040 instruction. Normally, the end of an ordinary record should have a 
marker of value 1, Thus, using B6 to specify a transfer of 25 words, we 
would write 

121 6 25,1 

To transfer 25 words (as specified in B6) starting at address 2000, we would 
then write 

1040 6 2000 
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laxample ; 

xjr±±J^ilTJ: f "" ""^S ^nn"*^ t^""^ ^^ "^^^ ^ location 8000 omards, 
./rite the 30 rows of 100 nmbers each, as 30 separate records star- 
tmg at the begimung of section S on tape 4. 

•1)H 



5) 



8 











1044 


4 





A1 


Search for section 8 


1032 


4 





10:0,1 


Start Writing to tape 4 


121 


1 





29 


Set row count 


121 


2 








Clear morlifier 


121 


3 





100.1 


Prepare to transfer 100 


1040 


3 


2 


8000 


Transfer 


124 


2 





100 


Increase modifier 


203 


127 


1 


A5 


Count rows 



o-K n ^^^""^ reading variable length records from tape, it is necessary to 
obey a start reading" instruction. To start reading forv/ards, a 1030 in- 
struction must be used, and this nonnally takes the form 



1030 3a P:0.K 



This starts reading forwards from the next irord on tape 3a and selects it 
for succeeding variable length operations. It also sets up a buffer in 
blocks P to P + K inclusive; nonaally K = 1, giving a two block buffer. Thus, 
^n ^^f ^/^^^fjariable length records from tape 5, using main store blocks 
10 and 11 as buffer, we would write 

1030 5 10:0.1 

Thereafter, information may be transferred from tape 5, reading 
forwards, by using 1040 instructions. The Ba digits of the 1040 instruction 
ir^icate which index register has been used to specify the amount of infor- 
;-. ^' •■■'^^-^^ j.^au^Lj.1^ jLx-UiU uape, icais inaex register nor- 
mally specifies the maximum number of words to be transferred. It ma;^- also 
specify an end-of-record marker whose purpose will be explained later*. The 
number IS specified by the integx-al part, and the marker, if required, by 
the octal fraction. ^ t j 

•^. jJ^° ^^^^ °^ record at a time, the maximum length of record should be 
specified and the marker should be zero (or one). After the transfer, the 
same index register records in its integral part the number of words actually 
read, and in its octal fraction the value of the marker at the end of the 
record. Thus, to read a record of not more than 200 words to location 1500 
onwards, we would ivrite 

121 10 200 

1040 10 1500 

If the actual record were of 100 words terminated by a marker 1, then BIO 
would contain 100.1 after the transfer. 
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Thus, to read to location 200 the first row of the matrix recorded 
on section 8 in our previous example, we would write: 

8)H 8 

1044 4 A8 Search for section 8 

1030 4 10:0.1 Start reading f rom tape 4 

■^21 3 100 Prepare to read up to 100 woi*de 

of next record 

1040 3 200 Transfer 

When reading, it is possible to ignore end-of -record markers of less 
than a given value by specifying that value in the octal fraction of Ba be- 
fore the transfer. Thus, for example, by setting 500.2 in B3 before the 
1040 instruction above, we could read the first 500 elements of the matrix; 
the marker 1 vn?itten at the end of each row is less than the octal fraction 
2 set in B5 and woiald therefore b e ignored. 

The instructions to start reading or writing assume the tape to be 
positioned at a marker, either by previous variable length operations or 
word search. 

So far ?;e have only considered v;orking on one magnetic tape at a 
time, and in this case the start instruction selects that tape for all suc- 
ceeding tape operations. ITien working on two or more tapes, it is still 
necessary to use start instmiotions to initiate variable length working, but 
subsequently 1033 instructions must be obeyed to select whichever tape is re- 
quired. This "select" instruction chooses tape number Ba for succeeding 
variable leng-th transfers until the next select or start instruction. 

Example ; 

Tape number 2 contains a file of variable-length records star- 
ting at section 1. Each record is terminated by a marker 1, except 
the last record which is terminated by a marker 2. The maximiM 
length of record is 50 words. Copy the file to tape 5, section 1 
onwards. 

2)H 1 

"^044 •• 2 A2 Search for section 1, tape 2 

"•044 5 A2 Search for section 1, tape 5 

"•OSO 2 10:0.1 Start reading, tape 2 

'1032 5 12:0.1 Start v/riting, tape 5 

1) 1033 2 Select tape 2 

1 21 4 50 ) 

< Read next record to location 

1040 4 A6/ A6 onwards 

''053 3 Select tape 3 

■1040 4 A6 Write record 

210 127 4 A1 Jump if marker odd, EvA if 

marker even:. 
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9.4.i Variable Length Instructions 

In the previous section, a selection of the most impoirtant variable 
length magnetic tape instructions have been described and illustrated in 
order to explain how they are used. In this section, the full range of 
variable length tape instructions will bu defined, and there vrill be some 
repetition of information from the previous section. 

on tape in groups of words known as "records '% 7d.th a 21 -bit count and a 
3-bit marker on each side to denote the ends of tlie record* Thus the space 
on tape occupied by a record is one word more than the number of words of 
information. Each writing transfer forms one record on tape, A reading 
transfer may either read a specified number of words or recA wp to the end 
of a record; in both cases markers are omitted from the transfer. Instruc- 
tions to start reading or writing must only be given when the tape is posi- 
tioned at a marker. 

A number of consecutive records often form a larger unit, such as a 
complete matrix or a complete file, and it is often desirable to mark this 
in some way. For this reason eight orders of marker, numbered to 7, are 
provided. Ordinary records may be terminated l)y a marker of order i , groups 
of records by a marker of order 2, and so on up to 7, which normally denotes 
the beginning or end of a file. Reading transfers may then read up to a 
marker of a specified order, and the progra?. may tost the value of the mar- 
ker read. Use of the marker is not recommended. 

Variable length world.ng must always be initiated by a start instruc- 
tion. This sets up a buffer store, selects the tape to be operated upon, and 
specifies the mode of operations, whether write, read forwards or read back- 
wards. A separate start instruction must be gdven for each tape on which 
variable length transfers are required, but thereafter a select instruction 
may be used to choose the tape to be used. The transfer instruction operates 
on the tape which was last selected by a start or select instiruction, and 
transfers information in the mode selected for that tape. To change the mode 
it is necessary to obey another start instruction. Unless the tape is alrep-dy 
in variable leng-th mode, the instruction to start writing begins by writing 
a marker of order 7. To start writing without commencing with a 7 marker, 
the sequence I7ord Search, Start Reading Forx/rj-ds,, Start Writing, Transfer 
should be used. /atern£>tively, the 104-2 'nark' instruction may be used after 
the instruction to start \Triting. 

A start instruction always initiates variable length transfers to or 
from the next v/ord on tape or the previous viord. in the case of reading back- 
wards. To begin working at a particular address on tape, the start instruc- 
tion must be preceded by the word search instriiction, 1044; when starting to 
read variable length records, this starting address must be the address of a 
marker at one end of a record* 

The variable length writing operations do not provide a means of 
overwriting selected words on a magnetic tape: complete new blocks are 
formed in the buffer and the previous contents of the tape are not preserved. 
If it is requiiTed to preserve the beginning of the first section, this may 
be done by preceding the start writing instruction by a start read-ing for- 
wards instruction \'7ith K = 0. 
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It is important to note that, when using a buffer of K+1 blocks, the 
attempt to read variable length records backwards from any of the first K 
sections, or forwards from any of the last K sections, will lead to an end- 
of-tape interrupt. K sections should therefore be left unused at both ends 
of the tape. 

9«4.2 Start and Select Instructions 

In the following specifications, P is a block address, and K an octal 
fraction, as above. 

1030 Start Reading Forwards 

Start reading forwards from the next word on tape Ba and select 
it for variable length operations. Set up a buffer in blocks 
P, Ph^,.. *, P-fK. 

If this instruction is given when the tape is already in read 
forv^ards mode, then the tape vdJLL be wrongly positioned. 

"lOS"! Start Reading Backwards 

Start reading backwards from the previous word on tape Ba and 
select it for variable length operations. Set up a buffer in 
blocks, P, P + 1, ..., P +K. 

1032 Start Writing Forwards 

Prepare to write forwards starting at the next word on tape 
Ba, and select it for variable length operations. Set up a 
buffer in blocks P, P +1, ..,, P +K. 

Also, write a marker 7 before the first word of infonnation, 
provided that the given tape is not already in use for variable 
length working. If the tape is already in use for variable 
length working, the marker written will be equal to the marker 
at the end of the previous record. 

The three 'start' instructions 1030, 1031 and 1032 must be preceded 
by a 1044 word search, even v/henthe desired vrord is the first in the sec- 
tion. To give predictable results, the tape must be positioned at a marker 
whenever a 'start' instruction is used. The K+1 block buffer must have been 
allowed for in the job description (see Chapter 10). If one of these blocks 
is already in use by the program, the information in it will be lost. 
Strings of information with markers at either end are tranjjferred to and 
from these blocks by the 1 040 instruction. V/hcn a buffer block has been 
filled in the writing mode, it is transfcjrrod to tape; v/hen completely read 
in the reading raods, the next section is read from tape. The buffer blocks 
are not protected from the program, but should not be referred to directly. 

It may be desirable to read variable length records from a tape fcr 
a while, and then begin writing to the very next record. 1032 will switch 
modes in this way; the first record written v/ill begin with the same marker 
as that terminating the previous record. 

1 033 Select 

Select tape Ba for succeeding variable length operations, in 
the mode specified by the preceding start instruction for that 
tap6. All succeeding 1040, 1041 and 1042 instructions apply 
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to tape Ba until another tape is Beleoted, If a write biiffer 
had previously been set up for tape Ba, its contents v/ill be 
voritten to tape, and a new buffer set up. Records will be 
written as if tape Ba were selected throu^out, 

Extracodes 1030 and 1031 above assume that the tape to be read from 
has been previously written by variable length operi.tions. If this is not 
the case, the extracodes.1034 and 1035 should be used instead. 



^ O'^iA Q4-r,-«4- "D^-^J.-- "W---, -3- -n -n. i -r-,-, 



As 1030, but operating on a tape which has not been written 
in the form of variable length records. 

1035 Start Reading Backwards Prom Fixed Blocks 

As 1 031 , but operating on a tape which has not been written 
in the form of variable length reooipds. 

9«4.3 Transfer and Organizational Instructions 

Notation: b = Integral part of ba (bits 1 to 20) 

"^ (0 <b < 2?-^) ^ 

^ - w ' 

b = Octal fraction of ba. 

{0<\<7) 

1040 Transfer 

Transfer up to b v/ords bet^veen store addresses starting at 

S and the selected tape, in the mode (reading forv/ards, 
reading backwards, or writing) appropriate to that tape^ 

On writing, b words from locations S, S+1, ..., S+b ~i 

w Ysr 

are written to the next b locations on the selected tape. A 

w ^ ' 

marker b^^ is v/ritten on tape after them. On Reading, provided 

that b_ ^ 0, the transfer continues vmtil b words of infor- 
w • - ■ST 

mation have been read or until a marker > b, is encountered, 

whichever is thti sooner. " 

"b^' = the niMber of words of information actually read. 

b, = if no marker > b, was eneountereti. 

= m if a marker m (> b ) terminated the transfer or 

immediately follov/ed the last word transferred. 

I'Then reading forv/ards, the next b ' words are re?vd from tape 

w ^ 

to store locations 

S, S+1, .......,, S +b ' - 1 

' w 

Y/hen reading backwards, -blie previous b ' words are read from 
tape to store locations ^ 

S, S-1,. , S-b'+l 

' ' w 

If b^ = when reading forvvards, the transfer continues until 
the first marker > b, is encountered. Mien reading baokivards 
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with b- and b zero, the transfer continues until the end of 



the first record, and the b ' vrords of the record are read to 
store locations ^ 

S, S-1, , S-b ' +i 

It is not advisable to v/rite vfith the octal fraction b, « 0, 

because when the resulting string, which therefore ends with a 

zero marker, is read back, the octal fraction b, will be zero 
' ' k 

regardless of v/hether reading ended at the zero marker or some- 
where short of the marker within the string itself. 

1041 Skip 

Skip b words, terminating on a marker b, • 

Skip operates in the same way as transfer, except that no 

words are transferred to or from the program store* 

When in a writing mode, b addresses on tape are skipped and a 

marker b, is written after them. Note, hov^ever, that the pre- 
vious contents of these addresses, v/hether information or marker, 
are not preserved on tape, except when complete 512-word tape 
sections are skipped. 
When in a reading mode, the skip continues until b words of 

information have been passed or until a marker > b, is encoun- 
tered, whichsver is the aconer. 

b ' = the number of words of information actually skipped. 

b, ' = m if a marker m (> b, ) terminated the transfer or came 

immediateHy after word b. 

Note that skip is less efficient than search for moving long 
distances along the tape, and should not be used for skipping 
more than a few sections. 

1 042 Mark 

Available only when in writing mode. 

Writes a marker K (0 <K <7) after the last word on the 
selected tape. This marker replaces any marker which was 
previously on the tape at this point. 

After writing a string on tape, it may be discovered that the 
end of a group has been reached. The mark instruction may 
then be used to change the marker at the end of the string. 
It may be used again if it is later found that the end of an 
even higher order group has been reached. 

A mark instruction may also be used immediately after a start- 
writing instruction, to vn:*ite the specified marker before the 
first record to be written. 

1045 Stop Variable Length 

Stop variable length operations on tape Ba. 
After variable length operations for a given tape have been 
completed, a stop instruction may be given; it will release 
the biiffer blocks associated with those operations. After 
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writing operations, it will cause the last part-section to be 
written from the buffer to magnetic tape. The following in- 
structions also have the effect of stopping previous variable 
length operations: 

start, search, unload, release tape, end program. 

f/henever variable length v/riting is terminated on a given tape 
each buffer block that contains information transferred there 
by a 1040 instiniction is v/ritten to tape. A buffer block is 

means that the first few T;ords of the last buffer block written 
may contain the end of the final record, or even just the final 
marker, and the rest of the block contain perhaps the remains of 
some previously transferred records. This fact permits one to 
overwrite individual recoils without disturbing the records on 
either side. This is done by filling the biiffer with the re- 
cord that is to be ove3rv7ritten along x/ith the records, or part 
of the records, on either side of it. One aligns on the marker 
at the beginning of the record and starts reading forward ("1050) 
with a buffer large enough to contain the whole record at one 
time. One then skips (1041) the record in qiiestionj^ starts 
residing back?;ard (1031, with the same buffer) and skips back 
over the record to the beginning marker. One switches to write 
mode (1032, same buffer again) and writes the new string in 
its proper place, A 'stop' instruction (1043) will then finish 
the job by causing the buffer blocks, now containing the new 
string in place of the old, to be vfritten back to the tape. 
The two uses of the skip instruction are necessary to make the 
marker at the beginrdng of the old string available for the 
construction of the marker at the beginning of the ne?/ string, 

1044 Word Search 

Search tape Ea for the section and word specified in the fioll 
word with address S. Stop variable length operations on tape 
Ba, The section and word are given as 21 bit integers in the 
more and less significant halfworxis in full v/ord s respectively. 
The section number must be greater than 0, and less than 5000; 
the word number is taken modulo 512, This instiniction must be 
■used to align the tape on a marker before using a 'start' in- 
struction; after tl:^ word serroh, a 'start' instruct-ion is- 
necessary before further variable length operations on tape 
Ba« 

1036 Set ba' = niamber of selected tape 

Place in bits 10-16 of Ba the program number of the tape cur- 
rently selected for variable length operation. If there is no 
tape currently selected, ba' 'iduLl be negative. Bits 10-16 
correspond to the Ba position in the more significant haJfviord 
of an instruction. One application is to enable a sub-routine 
to select a different tape for variable length transfers, and 
then to re-select the original tape before the main program is 
re-entered, 

1037 Store 'mode of tape Ba' in S 

The transfer mode at present selected for tape Ba will be in- 
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dictated by placing in half-vrard S the appropriate integer from 
the following table :- 

Variable length transfers, reading forwards 
from variable length records 

i Variable length transfers, reading backr/ards 
from variable length records 

2 Variable length transfers, writing variable 
length records. 

3 Not currently seleeted for variable length 
transfers. 

4 Variable length transfers, reading forwards 
from fixed length blocks, 

5 Variable length transfers, reading backwards 
from fixed length blocks. 

Ex amples : 

i. Tape ^ contains a file of variable length records and tape 
2 contains araendments to this file. The information on each tape 
starts at section 1 and the records are not more than 40 words long, 
Sach record is terminated by a marker i , except the last record which 
is terminated by a marker 2, Each recoi-xi is identified by a key in 

ITiS 1 irS"U riaJLL -WUI'U, ailU I^IIC i.-CUUiUiS j.xji caun ±j-j-c; c*j.c owi oe>u. j-iA ou- 

oending order of keys. It is required to form an updated file on 
tape 3 by inserting the amendment records in place of the correspon- 
ding records on the original file, 

1)H 



^) 



5) 



i 









1044 


1 





A1 


1030 


1 





20:0,1 


1044 


2 





A1 


1030 


2 





22:0.1 


1044 


3 





A1 


1032 


3 





24:0.1 


1033 


2 








121 


12 





50 


1040 


12 





100 


1033 


1 








121 


11 





50 


1040 


11 





150 


1033 


3 








101 


10 





150 


102 


10 





100 


214 


127 


10 


A7 



Initiate variable length 
operations on tapes, 



1, 2 and 3 



Read Amendment Record 



Read Main-File Record 



Select Updated File 

(k) to A7 if Amendment Key 
equals Main-File Key 



(Program continues on next page) 
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7) 



i040 


11 





150 


Write Main-Pile Record 


210 


127 


11 


AS 


Go to read next record, if 
marker is odd 


1117 











End Program 


1040 


12 





100 


V/rite Amendment 


210 


127 


12 


A4 


Go to read next amendment 
amendment marker is odd 


1042 








0.1 


Write a marker one 


210 


127 


11 


A5 


Go to read next Mni.n-File 
record if' marker is odd 


1042 








0,2 


Mark end of updated file 


1117 











End program 



HI 0,1 77 








1044 


53 





A3 


1030 


33 





1: 


1041 











1031 


33 





1: 


1041 











1032 


33 





1: 


121 


75 





50 


1040 


75 





A3 


1043 


33 









2» There is a 50 word record in section 10 of tape 33 which is 
preceded by a '7' marker in vrord 177. Replace that record with the 
50 consecutive words beginning in the stoi^ at A3, leaving the '7* 
marker undisturbed. 

3) HI 0,1 77 Section 10, word 177 

Search for marker 

Fill the one block buffer 

Skip to the end of next record 

Read backvTard 

Skip back to head of record 

Switch to write mode 

Replace record in buffer 

Vfrite block 1 : to section 1 

Although the length of the string was Icnown in advance and BO men- 
tioned in both of the skip instructions, one could use one of the 
sk3^ dj^truotions to ^lok up the length of ih©. atrijag- ija^ ^ ^li.TM^» 

If the 1 032 write instruction is replaced by a 1 042 mark instrxiction, 
the program will replace only the mark at the head of the string. 

9.4,4 Efficiency of Variable Length Yforking 

The basic magnetic tape operations on Atlas transfer information in 
blocks of 512 v/ords, but the variable length instructions disguise tliis fixed 
block structure. Provided that the length of transfers is small compared 
with the size of the buffer, these instructions also provide overlap of tape 
transfers and computing. To achieve these effects, extra vrords are written 
on the tape as markers and extra instructions are obeyed to transfer the in- 
formation between the buffer and the program store. Provided that the vari- 
able length records are not too short, the loss of efficiency is not hi^. 
With a two-block buffer and records of 50 to 150 words, the use of variable 
length instructions might be expected to increase the cost of a job by per- 
haps 1^ or 2^ This efficiency will be maintained vdth longer transfers 
also, iDut the automatic overlap of t ransf ers with computing will b e lost as 
the transfer size approaches the buffer siz^. 
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9,5 Organizational Instiniotions for One Inch Tape 

A nuraber of organizational instructions are provided to cope with 
special situations v;hich vdll arise in some magnetic tape programs. Many of 
the operations v/hich these instructions perform are usually required near 
the beginning or end of the program,- and they are then best left to the job 
description or the 1117 (end program) instruction. One exception to this 
rule is the instruction 1017 (Free Tape), which should bo used before the 
1117 instruction if the infonmation on any titled tape is not required again. 

Programs frequently require to use magnetic tapes as working space, 
without wanting to koep them after the job has been run. Such magnetic tapes 
shoxild be requested under a heading TAPE COMON in the job description. 

For a long job, it mr.y be desired to restart the job after a machine 
failure severe enough for common tapes to be lost; in such a case tapes should 
be requested under TAPE NEW, In exceptional circumstajices a title may be 
written to a common tape, which is then kept by the user after the job has 
ended; the operator will bu notified, and the Atlas installation may take 
action to discourage a user from doing this at all often.. 

The title stored in section of the tape is referred to by extra- 
codes 1014 and 1015 (Write Title & Search for Block 1, and Read Title or 
Tape Number), These refer by its main store address to a copy of the tape 
title, stored as one record; the 6-bit characters are packed 8 to a word and 
the last character is binary zero. 

9.5,1 Mount Instructions 

If a program requires to use magnetic ta,pe, its job description must 
indicate the number of mfignetic tape mechanisms required. NoiTmally this is 
done by listing the magnetic t ape s vfhich ar-e required to be mounted on these 
mechanisms initially: the Supervisor v;ill then ensure thr^t these tapes are 
momitod before the progrc'im is entered. The details of hov; the job descrip- 
tion is preprj:'ed are given in Chapter 10. 

If further magnetic tapes are required after a program has been en- 
tered, they should be listed in the job description and may then be called 
in by obeying "mount" instructions'. However, the total nimber of mechanisms 
in use at any one time must not exceed the number reserved in the job des- 
cription. A mount ins timet ion should, if possible, be obeyed at least 2 
minutes before the tape to which it refers is required; otherwise the tape 
may not be ready in time and the progrcx\ v/ill have to wait. Note that the 
program will be monitored if it caJls for a nev; tape to be mounted at a time 
v/hen none of its reserved mechanisms has been made free. If there is a spcxo 
tape mechanism, the ta,pe may be mounted on it by the operator before the pro- 
gram calls for it. 

The tape reference letter referred to in the mount extracodes is a 
letter associated with the tape in thu job description (see chapter 10). 

The mount instructions are as follov/s:- 
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1010 MouTxt 

Allocate the number Ba to "toe tape whose tape reference letter is in 
the 6 least significfuit bits of n, in internal code. If this tape 
is not already available^ irstrtaet the operator to mount it on ax!^ 
available tape mechanism. If the tape is in the TAPE category, check 
its title; if in the TAPE NEf category, write into the section the 
title given in the job descrip1;ion: if in the TAPE COiviMON category, 
leave the tape untitled. 



Allocate the number Ba to a free t^e. If no free tape is available, 
instruct the operator to mount one on csny available tape mechanism. 

This extrocode should only be used in exceptional circumstances ; 
normalHy all tapes recjuired shoiJLd be listed in the job description. 
The operator will be informed whenever this extracode is used, and an 
installation may take action if it is used overmuch. 

100^ Mount Next Reel of File 

»i— — «— I III u.— ,— „— a— .^ii«jM,i,»pim,» 

Allocate the number n to the next reel of file Ba, If this tape is 
not mounted, instruct the operator to mount it on any available 
mechanism. 

The following mount instructions refer to logical channel number 
(K = to 3) of a given program. These logical channel nimibers do not each 
refer to a fixed magnetic tape channel: they are merely a device to enable 
the program to separate on to different channels the magnetic tapes that it 
requires to operate simultamsously. On an installation rath only one tape 
mechanism on each of the ei^t tape channels,, there is no advantage in spec- 
ifying channel numbers. On l£U*ger djistailations, the tape mechanisms are 
grouped together on pairs of channels^ aaid the logical channel numbers then 
refer to these pairs. 

A T>T»o'Tam's ref errljp'^' to* lo^dksal channel number K has the- following 
effect. If no channel has^ been previousij'^ designated logical channel K of 
the pro^rjn, the new tape is mounted, if possible, on a channel different to 
any which has been previously designa'l^d a logical channel of the program; 
that channel is then designated logicfal channel K of the given program, 3f 
a channel has been previcusly d asigntrted log^cttL channel K of the program, 
then the new tape is mounted on i^e same channel, if possible, A channel may 
also be designated logical channel K of the progre^ by the Job Description; 
see chapter 10. 

1012 Mount on Channel K 

Allocate the number Ba to the tape whose tape reference letter is in 
the 6 least signifioawfc bits of n^ in internal code. If this tape 
is not already available, intftrocft? the- operator to mount it if pos- 
sible, on channel K of this pro^raia, where K is the most significant 
octal digit of n*' l^f the Tapfe is in the TAPE category, check its 
title; if in the QIAEB NEW categpi^, write into section the title 
given in the job dfesorlption|, M dte i^ne TAPE COMMON category, leave 
the tape untitled. 
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1 01 3 Mount Free on Channel K 

Allocate the number Ba to a free tape. If no free tape is available, 
instruct the operator to mount one, if possible, on channel K of this 
program, where K is the most significant octal digit of n. 

Note that this extracode, as 10ii, should be used only in very excep- 
tional circumstances; normally all tapes required should be listed in 
the job description. The operator will be informed whenever this 
extracode is used and an installation may take action if it is uaed 
overmuch. 

9»5,2 Other organizational Extracode s 

iOi4 Write Title & Search for Block i 

Write to section of tape Ba the title stored in location S onwards, 
oveiwriting any title that may be there. Inform the operator that 
this has been done, 

i015 Read Title or Tape Number 

If S is even (least significant bit. is 0), then store in locations 
S onwards the title of tape Ba, i.e', that currently in section 0, 

If S is odd (least significant bit is i ), then store in location S 
the tape serial number of tape Ba;. 

In 1014 and 1015 S is taken as a half v;ord address- The tape serial 
number stored by 1015 will be in internal code, left justified, 8 characters 
in length, 

1016 Unload and. St ore 

Rewind tape Ba and disengage the tape mechanism on which it is mounted^ 
Instruct the operator to remove the tape, ensure that the correct 
title is written on the spool, and store it for later use. If n ^ Op 
the number of tape mechanisms reserved for the program is induced by 
one, 

1 01 7 Free Tape 

Overwrite the title on section of tape Ba and return the tape to 
the Supervisor as a Free tape for general use. If n ^ the number 
of tape mechanisms reserved for the program is reduced by one, 

1020 Releas e Tape 

Delete tape Ba from the allocation of this program and make it avail- 
able for another program, which must call for it by its correct title. 
The tape is not freed and is not normally disengaged. If n ^^ 0, the 
number of tape mechanisms reseiTred for the program is reduced by one, 

1021 Free Mechanisms 

Reduce by n the number of tape mechanisms reserved for use by the 
program. 
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i022 Re-number 

Allocate the number n to the tape which was previously referred to 
in this program as tape number ba« 

This enables a tape to be given a different number during & subiwifcij:^, 
and then to have its original number restored at the end of the sub- 
routine, Note that in this instiMction the tape number is ba and not 
Ba* 

s' = Number of 512-word sections available on tape Ba (exclirLing sec- 
tion 0)» The number of sections available on a standard-length tape 
is 4999, but this instruction may be of value if shorter tapes are 
used. The tape wiU be rewound. 

1 024 ^?here am I? 

s' = A; s*' = Yf (0 <W < 511). 

This instruction places the address of the next section (going for- 
v/ards) on tape Ba in the first half-word of the specified full-word 
address. After variable length transfers, the second half-word con- 
tains the position in the section of the nsxt vford to be used. After 
block transfers, the second half-wo2?d is zero. 
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9.6 Specification of the Atlas One Inch Tape System 

9.6.1 Control 

An Atlas installation may have as few as 8 one inch magnetic tape 
mechanisms, or as many as 52. Each mechanism is connected vdla one of ei^t 
channels which can operate simultaneouslj'-, each channel controlling one 
read, write, or se.-rch operation. 17ind and rewind operations are autonomoxis 
and need the chamiel only to initiate and, if reqiiired, to terminate them. 

The layout of the control eystem depends on the individual instal- 
ation. Yifhen there are only 8 mechanisms, each mechanism has its own control 
channel, lii/hen there are more than 8 mechanisms, the 8 channels are grouped 
into 4 pairs and some or all of these pairs are adapted to control up to 8 
mechanisms; any two of the mechanisms on one such pair of channels can then 
operate simultaneously at any one time. 

9.6.2 The Tape Layout 

The tape mechanism is the Ampex T^i2, using one inch wide magnetic 
tape. There are 16 tracks across the tape, used as follows: 

12 information tracks 

2 clock tracks 

1 block-marker track 

1 reference-marker track (for Tape Addressing 
only) 

Information is stored on tape in blocks or sections of 512 48-bit 
words, followed by a 24-bit checksum. Hach section is preceded by a leading 
block marker and a section address, and terminated by a trailing block mar- 
ker and a zero address. Tapes are tested and pre-addressed by a special 
run on the machine before they are put into use, and the fixed position of 
addresses permits selective overv/riting of sections. Checksums are of 24 
bits vd-th end-around carry; they are used to check the accuracy of all reading 
and writing operations. 

^A 48-bit word is represented by four lateral stripes of 12 infor- 
mation bits, and a checksum by two stripes. Each 512-word section of infor- 
mation contains 2050 stripes and has an average length of 5.46 inches, with 
a gap of 2.3 inches between sections. Tapes are 5600 feet long and hold 
5000 sections, or 2-g- million 48-bit words. 

9.6.3 Performance 

The normal tape speed is about 120 inches per second and there are 
375 binary digits per inch on each track. This gives an instantaneous trans- 
fer rate of 90,000 6-bit characters per second, or one 48-bit Atlas word 
every 89 micaroseoonds. Allowing for the gaps between sections, the effective 
transfer rate is about 64,000 characters per second. This is equivalent to 
one 512-v/ord section every 64 milliseconds, or one word every 125 microseconds, 
on average. There are also fast wind and rewind operations at about 180 
inches per second, and these are used for long searches along the tape. 
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There are independent write and read heads, separated by a gap of 
about ,39 inches, Y/hen not operating, the tape stops vdth the read head 
roughly midway between sections, ready to read the next section address. 
It is possible to read when the tape is moving either in the forwaird or in- 
verse direction, but writing is only possible when the tape is moving for- 
wards, 

9.6,4 Safeguards 

of store "vriiich is involved in a magnetic tape transfer. The Supeirvisor may 
then enter another program until the transfer is completed. 

If a magnetic tape block transfer cannot be initiated when it is 
requested, it is placed in a queue. If the queue is already full the p2?ogram 
is held up, 

A write-pemiit ring must be fitted to a reel of tape before that reel 
can be written on. Tapes containing permanent information will jxit have such 
a ring, A write-inhibit switch is also provided on each mechanism, which the 
operator can use to isolate the tape. It is only possible to write on a tape 
when the write-permit ring is on and the write current is sTfitched on. 

The address of the relevant section on tape is checked before all 
reading and writing operations, to make sure that the correct section is 
used. The information in each section is checked by means of a 24-bit check- 
sum at the end of the section: this checksum is used to detect faulty writing 
or reading, which caiise the operation to be repeated under the control of the 
Supervisor, 

V/hen a magnetic tape has useful infonaation on it, a descriptive 
title of that information is stored in block of the tape. This is in 
addition to the tape serial number, which is permanently associated with the 
tape and is unalterable by the user. This tape title can be up to 80 char- 
acters long, though the Supervisor prints out only the first 30 characters 
in operator messages. It is stored on tape in Atlas Internal Code with tab, 
and multiple spaces (including tab,) replaced by a single space; initial 
spaces, tabs, full stops, and commas are ignored. Shifts are ignored through- 
out the title, (see Chapter 10.) 
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9,7 Orion Tapes 



It is possible to i^ad into Atlas tapes prepared on the I»C,T, Orion 
Coraputer. This is accomplished by the use of the following two extracodes. 
P is a block address, and K an octal fraction, of the form P:0,K. 

i04S Read Orion tape Ba forwards 

A check is first made that tape Ba is in fact an Orion tape (if it 
is, zero T;ill have been read from the first bit of the first block 
when the tape was moimted). Then, reading forwards, the next sec- 
tion is read into store blocks P onwards, K + i blocks v/ill be re- 
served for the transfer - if this is not sufficient, the p2X)gram \irill 
be monitored. Up to 4096 words may be trr.nsferred, but there is no 
automatic indication of the number of woixis actually read, 

1048 Read Orion tape Ba backr/ards 

This is very siiiiilar to 1046, the difference being that the first 
wor^i transferred is placed in the last v.'-027d of block P + K and the 
tape is read backivards. 

Some of the organizational instructions listed in section 9.5 may be 
used with Orion tapes. These are given below, 

1 01 Mount 

1007 Mount Nert Reel of Pile 

1012 Mount on Charmel K 

1015 Read Title or Tape Number 

1016 Unload and Store 

1020 Release Tape 

1021 Free Mechanisms 

1022 Renumber 

1023 How Long? 

1024 Vvhere am I? 

The section number only will be given; the second half woird 
will be zero. 

The title read by the 1015 instruction v/ill consist of up to ten 
words separated by /, the vTords containing up to eight characters. The. 
characters will be letters, digits or full stop. 

In the Job description (chapter 10), Orion tapes must be listed 
under Ti\PE headings, and the title must be given in the form described for 
the 1015 extracode. 
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Chapter iO 

PESPARir^ A COMFLSTE PROG-HAM 



This chapter explains the way in v^hich a program, and the input 
infonnation it uses are prepared for running on Atlas, 

10#i Atlas Jobs 

Each run of a program on Atlas is kno^vn as a job; it may range fi*om 
a small job, for vrhich there is no data outside the program itself, to a 
large job requiring several batches of data, possibly arriving on different 
media, e.g# piaiched cards and paper tape. 

The varioiis parts of a job may be siibmitted separately to the com- 
puter each on one deck of cards or length of paper tape, or two or more parts 
may be combined on a single deck or tap©. In any case each part must be pro- 
perly identified for the computer and for this purpose the concept of a 
'document' has been introduced. 



( 1.65 ) 



i0.2/i 

10,2 Documents 

A dociment is a self-contained section of information presented oo»- 
tinuously to the computer through one input channel (but see also 10.i0.5). 
Typical examples of a document are a collection of data on a length of paper 
tape or the program itself. 

Each document carries at its head suitable identifying information 
as detailed in 10.3.1, The end of a document is indicated by an 'end of 
document marker' v/hich usually'- consists of the characters **'^Z on a new line, 
or a 7, 8 punching in the first column of a new card xrhioh follows the last 
record of information of the document. 

By means of the identifying infonnation the Supervisor prepai^es a 
list of documents as they are accepted in the store and it also keeps a list 
of jobs for which further documents are av/aited. A job may require several 
documents and only when all these have been supplied can execution begin. 
The Supervisor therefore checks the appearance of each document; when all 
have been entered v/ork on the job may commence. Documents for a job may thus 
be fed to the computer in any order. 
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10,3 Document Headings and Titles 

Every document is preceded bj the identifying information mentioned 
auove* xiiiLs consxs u5 Ox a lie so "i ng and tue oxuXe Ox uixe vxocumenu* 

10.3.1 Headings 

The heading indicates which type of document follows and must be 
one of a standard list. The most conmon types of heading are as folloT/s:- 

a) COMPILER (which is follov/ed on the same line or card, after 
one or more spaces, by the name of a program language). 
The document following this heeiding is a program in the 
stated language. Available languages include Atlas Basic 
Language (ABL), Extended Mercury Autocode (EMA), ALGOL and 
tlARTRMT (for Fortran). 

For an Atlas Basic Language PiHDgram the heading will be 

GOtiPILER ABL 

b) DATA 

The document follov/ing consists of data required by a program. 

c) JOB 

The following document is a request to the computer to execirte 
a job and gives relevant facts about it. 

The last type of document is called a 'job description'. It gives, 
for example, a list of all other dooiments required for the job and a list 
of output streams the program will prodiice. It is described in detail in 
sections 10.4, 10.5 and 10.6 belovf, 

10.3.2 Titles 

The title of a document consists of one line (or one punched caiTd) 
immediately following the heading. It may be composed of any combination of 
characters obeying the rules of section 10,3,3 below. The prime consideration 
is, however, that it should be unique among all "i±ie documents stored in the 
computer at the same time. This is obviously made essential by the time- 
sharing facilities of Atlas, to avoid confusion betvreen documents intended 
for different jobs. 

A document will thus usually take one of tl0fee forms exemplified by 
the following, the second line of each document being its title :- 



JOB 

F6479, SMITH ;I,C.T. 



(Job Description) 



# « « 



£u 



COlvIPILER ABL 

F1 , SmVEI PROG-BAM 



(Program) 



« «: '41 



DATA 

F6479 BEETLE SURVEY 



(Data) 



iii * ff 



Job Description Program Document Data Document 
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10, 5, 3 Rules for Title Preparation 

Besides being unique document titles must obey the following rules :- 

a) The title must begin with an identification of the person or or- 
ganization v/hich originated the document: noi-mally this i^'ill talce 
the form of an account number or name. For example, documents 
prepared for the I.C.T. Atlas Computing Sei-vice are identified 
by a letter F follov/ed by an account number. 

b) The number of characters must not exceed 80. 

c) 'Backspace' must not be used. 

d) A title must not contain three successive asterisks ('*•**), 

e) Titles must not begin with the word END or the vrarni TAPE, 
Furthermore : 

a) The characters of a title are i^ad in and stored in Supervisor 
records in Atlas internal code in the normal way, but the shift 
characters, 04, 05, 06, 07 are subsequently removed. This means 
for exajuple that en the Plexowriter "the titles 

fTape] 
and 

1 TAPE 3 

are identical. For the same reason a length of run-out appearing 
on tape in the midst of a title would not become part of the title, 

b) knj number of consecutive spaces and tabs are stored as one space. 

c) Erases do not become part of the title. 

d) Initial commas, spaces and full stops are ignored. 

Documents used in the same job need not have related titles. 

The job title itself normally contains the name and abbreviated 
address for the return of the results, but this is not necessary in the titles 
of data and program documents. 

If necessary the title of a data document or job description (but 
not a program document) may be on the same line^ or card, as the heading, 
provided sufficient room remains to accommodate all the title on that line or 
card. In this case the heading and title must be separated by 'comma', 
'space' (one or more), or 'tab'. 
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10,4 The Input and Output Sections of the Job Desoription 

After idle heading and title a ^db description is divided into 
various sections each one describing a particular aspect of the job, e»g# in- 
put documents, store used and so on. These sections may be assembled in any 
order and are dealt x^ith individually below in sections 10.4.1, 10.4.2, 10.6, 
10.7 and 10.8, 

10,4,1 The Input^ Section 

This section begins \7ith the word 

INPUT 

which is folloT.'ed hj the titles of the data documents used in the job, each 
preceded by the number by vfhioh the program refers to them:. These numbers 
must be in the range to 16. The program document itself usually is given 
number 0, but is in fact always taken to be tlie lowest numbered data document. 
Thus, if a program operates on two data documents which it refers to as iit- 
puts one Sink tfro respectively, the job description would contain 

INPUT 

(Title of Program) 

1 (Title of Data 1 " 

2 (Title of Data 2] 

To take a concrete example :- 

INPUT 

ii , SURVEY PROGRAIfi 

1 F6479/2 BSETItE SUEVSI DATV62 

2 P6479 B3ETLE POFULi'iTION 1 961 

The data document "P6479/2 BEETLS SURVEY D2TA/62^ could then be selected by 
the programmer by the instruction 

1050 1 

Data ma^r be placed on the sanae tape as the program, v/here it becomes 
a part of the lox/est numbe3?ed input stiream. Yv'ith an ABL program such data 
must come between the enter directive and the end of document marker that ter- 
minated the progroiii stream. If the 1050 extracode is not used to select a 
given input strerara, the lt>west ntambered stream is Etssimed and oi^e obtains the 
data V7hich followed the program. 

The input section may also contain a reference to a magnetic tape on 
which an especially large document has previously been stored. This way of 
handling large amounts of input is explained in section 10.12.1. 

10.4.2 Tlie Output Section 

This section of the job description specifies the type of peripherals 
to be used for output. Possible types of equipment are:- 

LINE FRBITER 
Si^^JJ HOLS PUNCH 

c;rds 

five hole punch 

ANY 
TAPE 
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Here CARDS means the card, pimoh* Each Atlas installation will 
specify which types of equipment nay be used for output AM" e.g. MI may pro- 
■ duoe output on LIML' PRIjWSR or SEV^.JK HOLE PUNCH, TAPE is used when a private 
magnetic tape is called for to hold an especially large amoimt of output 
(see I0,i2.4). 

The output section begins v/ith the word 

OUTPUT 

which is followed by a list of output mechanisms, each preceded by a pro- 
grammer's number in the range to 15, For example one might have 

OUTPUT 

2 AM 

1 CARDS 

LINE FRirrTSR 

In this case, in order to send output to the card punch, the programmer would 
first have to select this form of output by the instiniction 

1060 1 

A request will be made to the operator to mount special stationery 
for a given output stream if an asterisk is placed in front of the wo27d LINE 
PRINTER. Thus if output streani 3 is to be printed on special stationery, 
the output section should contain 

*LINE PRDCER m LINES 

The type of equipment should normally b e followed by a limit on the 
amoimt of output, specified as so mai^ lines. One line is the output pro- 
duced by one use of the 1065 (end ©undent record) or the 1067 (output one 
recoi^i) extracodes. Thus one line means one printed or blank line on 5 or 7 
track tape and on the line printer, or one punched card. One writes 

OUTPUT 

LINE PRINTER m LUSS 

The maximum amount of output may also be specified as n BLOCKS'. A 
block contains 4096 characters. The number of characters allowed for must 
in general be larger than the number actually printed or punched. On the 
average each line output to punched paper tape or line printer requires an 
additional six characters (the maximum possible is 8) to be allov/ed for. 
Exactly 8 additional characters must be allovred for to punch one card (making 
88 all told). Purthennore each use of 1065 (end this record) to produce a 
blank line generates 8 characters *-.o be held in the output v/ell. 

If the number of blocks is omitted, one block only is allotted, and 
if the Tfhole output section is omitted 



OUTPUT 

AM 1 BLOCK 



is understood. 
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10,4«3 Output ; G-eneral Notes 

a) Output Output is used by the Sv^jeirri-sor and some compilers, 
"but is still available for normal output from the p2X>graiii« It is 
on this output that such information as the number of instructions 
done in compiling and executing the pi*ogram, the number of store 
blocks in use vtrhen the program endec3, the number of blocks accum- 
ulated for each 'stream' and other such items are printed. It is 
s_i-30 useu. J. or xau^is iniOxTnai/j-Oxi ~i < t-x^e "iroKrsm ^oes svroii^* 

If no output is mentioned in the output section of the job des- 
cription 

ANY 1 BLOCK 

is assumed. 

Similarly if no output stream is selected by the 1060 'select out- 
put n' extracode, any subsequent output will go to output 0, 

b) Atlas can readily accept two or more streams of output from a 
program for the same -type of equipment, even though on3^ one such 
equipment may exist. The streams are accumiilated independently 
within the computer and eventually output one after another. 

In fact all output is accumulated and none will be printed until 
all computing has ceased unless the extracode 

i07i Break output n 

is used. In this oaee all of the output stream n accumulated so 
far ^irill be sent to the peripheral. 

In either case the output information with programmer's number n 
will always be preceded by 

Supervisoiy Number / Date. Time 
OUTPUT n 
(Title of Job) 

The last line output gives the number of blocks sent to that 
output. 
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10,5 A Complete Job Desoription 

We are now in a position to give an exomple of a complete job des- 
cription and for the sake of illustration we include the documents of the job. 



JOB 

P64, J. Smith, I.CT. London, METALS 

INPUi) 

F64, ANALYSIS PROGRAl^i 

1 P64/A, IRON COlttENT 

2 F64/B, COPFSR COOTHOT 

OUTPUT 

LINE PRINTER 

i S-EVm HOLE PUNCH S BLOCKS 

* * »> 17 



Job Title 



Program Title 
Data Tapes 



output 

streams 

End-of-tape marker 



Job Description 



COIvtPILER ABL 

F64, ANALYSIS PROGRAM 

(Program) 



* * * 



• Z 




Program Document 



Data i 



Data 2 
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10.6 The Magnetic Tape Section of the Jo"b Description 

Magnetic tapes are "used v/ith Atlas in tvTO ways. Firstly, they 

are used by the Supervisor for such purposes as storing input and outpui. 

These are called System Tapes, and iinder normal circimistances need not coj>- 

cem the programmer at all. Their operation is quite automatic (see also 
section 10,12.3. ) 



either: 



or 



Seoondl'^'' the ■•^ro'Taminer m°"''' use ma'^'netic i-sj^QS in his Dro^rain 

a) For private input and output purposes 

b) by magnetic tape extracodes. 



The use of magnetic tapes for private input and output purposes 
will normally only be necessary if there is & very large amount of input 
or output. Full details of the vray in which such tapes are employed are 
given in section 10,12. 

The most common use of magnetic tapes is by extracodes within the 
program. The tapes required may be mounted on a tape mechanism (a 'deck ) 
before running the program or during the actiial execution. 

The tapes mounted before the job begins must be listed in the job 
description. Normally the tapes that are to be mounted while the program 
is ininning are also listed in the job description. However, in programs 
YThloh require a not-easily^predicted number of tapes it is possible to get 
tapes mounted v/hich are not listed in the job description. (Sections 10.6,1. 
and 10.6.2. ahow how to list tapes in the job description. The extraoodes 
for mounting tapes are described in Chapter 9, ) 

Full information on magnetic tapes can be found in chapter 9. How- 
ever, for the sake of completeness some of the relevant facts are repeated 
here- 

a) l3:iformation is stored on magnetic tapes in blocks of 512 48-bit 
words. 

b) The first block is known as, block 0, and is not available to 
the prograjmner. Block contains the serial nimber of the tape, 
and the title if the tape has one. The title of the tape must 
obey the rules of document titles given in 10.3.2 but also, if 
the tape serial number is not listed in the job description 
along with the tape title, the first 50 characters of the title 
must identify the tape uniquely. Only those 30 characters ere 
printed by the Supervisor vrhen calling for the tape, but up to 
30 characters are stored and checked. 

c ) In preparation for use each tape is mounted on a t ape deck by 
an operator who receives instinictions for the p\jrpose from the 
Supervisor. ''.Tien mounted, each tape is positioned by the Super- 
visor at the beginning of block 1, the first block available 
for storing information. 
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10. 6, 2 Single Tapes 



Each tape required for a job is specified in the job description by 
2 lines of printing:- a heading, and a description. The heading is one of 
three: - 

TAPE - a tape belonging to the user and 
already having a title; 

TAPE NEff - An untitled tape, not previously 

belonging to the user, to be titled 
and kept when the job is over; 

TAPE COMON - an untitled working tape to be retained 
by the system TThen the job is over. 

The description consists basically of the programmer's number (in 
the range to 99), the tape serial number (preceded by *) and the title of 
the tapes 

21 *F3699 PI 000, LONDON SALES, 1963 

This format applies vdth headings TAPE and TAPE NEW. That for 
TAPE C0MI40N is described later in this section. 

The programmer's number, 21 in the above example, is the number by 
which the tape will be referred to in the program. If the tape is not re- 
quired to be mounted before the job begins, but rather will be called for in 
the course of execution by a "mount" insti*uction (see Chapter 9), the pro- 
grammer's number must be replaced by a "tape reference letter" consisting of 
a single letter: 

D *P3700 FIOOO, LIVEEPOOL SALES, 1962 

The mount instruction will then refer to the tape by its tape re- 
ference letter and assign to it a programmer's nimber. In the example just 
given the tape title will consist of the 28 characters starting with F1000 
and ending with 1962 (i.e., the two double spaces will have been replaced by 
single space). 

The tape serial number, P3699 in the first example, is permanently 
associated with the tape. If possible, the Supervisor will call for the tape 
by its serial number, \mder which the tapes are filed; the tape number should 
therefore be included when possible even when its inclusion is not made oblig- 
atory by a particular Atlas installation. If it is omitted, the * is omitted 
also. 

Thus in the example 

19 T9824:, WOLVERHAMPTON SALES; 1962 
the title is the sequence of 31 characters starting with T and ending with 2. 

The title in the description is the complete title stored in bloek 
of the tape. Under a TAPE heading, this will be used to check that the cor- 
rect tape has been mounted; under TAPE NEWT, the title will be written to block 
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when the tape is mounted. In either case if the tape serial number is ab- 
sent the Supervisor refers to the tape by the first 50 characters of its title • 

The description for TjhFS C0N3viCN consists of a programmer's number or 
tape reference letter only, 

TAPE COIvMON 

36 

All the programmer's numbers and tape references in the job descrip- 
tion must, of course, be different. A progaraiimier ' s number must lie in the 
range to 99 inclusive ; a tape reference can be any letter. 

The descidption may refer to logical channel K of the program; the 
effect is the same as in extracodes i0i2 and -10-13. This is done by adding 
,K to the programmer's number. 

Thus: 

2i.3 '^psegg Fiooo London Si^ss 

would request that the tape be mounted on a 'channel' which ceji tlien be re- 
ferred to in the program as channel 3. Tapes on different channels can be 
written to or read from simultaneously. The extracodes -1016 and 1012/1013 
allow fiirther tapes to be mounted on the same channel, (see Chapter 9.) 

If a tape in the TAPE category requires file protection, i.e. no 
write permit rdng and/or no write current, an asterisk shoiild be written 

immediately b ef ore the description: 

TAPE 

*1 *F3002 PI 002 PMIS SALES 

Yfith file protection block cannot be \7ritten to, so it will not 
be possible to change tiie title of such a tape. The progrcjn will be moni- 
tored if the 1014 (change title) extracode is used on a tape vvith file pro« 
tection. 

10,6,2 Files 

A collection of information may extend over several tapes although 
the programmer may wish to treat it as a single unit. Such a collection of 
tapes is called a file and only one of the tapes needs to be mounted at any 
one time. Each tape of a file is specified in the Job Description by a mod- 
ified tape heading as follows: 

TA?l/m 

n (tape serial number) (Title of tape) 

where m is the number of the t ape \,dthin the file, counting: from 1 upwards. 
The programmer's number n will be the same for all m of this file. The final 
tape of the file is entered as 

TAFE/m EI© 

n (tape serial number) (Title of tape) 



( 1.65 ) 



10.6/4 

For example, suppose a file of information extends over three magnetic tapes 
which have respectively as serial numbers and titles in block 

Q1432 PI 012 BIPi/:iNGf-IMi S.4LES 

Q1003 PI 01 2 LCra)ON SALES 

Q1100 3J-I012 MANCHESTER SiU^S 

These would be referred to in the Job Description as 

tape/1 

3 *q1432 pi 01 2 bib.iijn&iimi sales 

TAPE/2 

3 *Q1 005 PI 01 2 L0M)0N SALES 

tape/3 end 

3 *Q1 100 PI 01 2 MANCHESTER SALES 

These tapes would then form file 3. The Birmingham tape alone would 
be mounted and allotted programmer's number 3, i.e. the same as the file num- 
ber, before the job begins. 

The remainins" +.n-n#=>s e-rva Tnon«4-/a/i oo ■«o,^i-?-«e>y5 v,- ,,„-» _j> j.\.^ i j. 

1007 (mount next reel of file Ba and allocate number n to it). The tape sec- 
tions on the second and subsequent reels are not numbered consecutively from 
the preceding reel, b ut start again at section 1 , 

10.6,3 Deck Allotment 

As stated above the first tape of every file and each single tape 
that is given a programmer's number in -che job description, will be mounted 
on separate decks before the start of the job. These decks will then be 
available to the progranimer throughout the course of the job. He can by 
extracodes cause any of the original tapes to be unloaded and new ones, given 
a tape reference in the job description, to be iuounted in their place. 

If* however, at some stage in tho program he requires more decks than 
will be allocated to him in this fashion, he must mention the number he will 
need in the job description. This is done "by writing: - 

DECIiS d 

where d is the maximum number of mechanisms that will b e in use at ai^r one 
time. Thus a programmer requiring 3 tapes to be mounted at some stage in the 
program but only 1 at the beginning, woiild give the sinf^;le tape a programmer's 
number, give the other 2 tapes a tape reference and put in his Job Description:' 

DECKS 3 
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10*7 Time Estimates for a Job 

10.7.1 Computing Time 

Since each program on Atlas will normally be time sharing vidth 
others there can he no direct control of an individual program by an operator, 
Thus, there is no means by which an operator may tell if a faulty program has 
entered an infinite loop and is thereby wasting machine time. 

To overcome this problem a time limit for a program is placed in 
the job description and if the program exceeds this limit it is stopped by 
the computer. 

The limit appears in the job description as:- 

COiviPUTING p.q SECOM)S (or MBJUTES, or HOURS) 

where p.q is a decimal number. This tiiae is found by allov.-ing two micro- 
seconds to each instruction obeyed and adding to thds the expected compiling 
time. The ABL compiler obeys 1500 to 1700 instructions per instriKjtion com- 
piled. 

Alternatively the limit on computing time may be specified as 

C0LIPUTIM3- m Il^TRUd'IONS 

but one 'instruction' in this context means one instruction interrupt, equal 
to 2048 basic instructions obeyed. In fact the Supervisor actually times the 
program in terms of these units of 2048 instructions. Conversion from esti- 
mates given in teras of seconds, minutes or hours is made on the basis of 256 
'interrupts' per second, PurthermG3£« each nijltiplication instruction is 
counted as 2 instructions ani each division instruction as 4, 

For example a program reqpiiring at most three million instructions, 
and having a compillag time of one and a half seconds would have the entry 

C0IAPUTIN& 7,5 SECOM)S 
or 

CCMPI3TIM5- 1832 INSTRUCTIONS 

If the computing time is less than 20 seconds this entry may be 
omitted completely from the job description. In this cage a standard allow- 
ance of 20 seconds is made (5120 instruction interrupts), 

10.7.2 Execution Time 

If a program uses magnetic tapes it m&j be held up at some stage 
while a block of information is brought from tape to store, a time of 64 
milliseconds. This wait can be eliminated in many cases by calling for a 
block 64 m.St before it is needed, or b^"- using a sufficiently large variable 
length transfer buffer or by resorting to branching. Some tape waiting 
time, however, may be inevitable and if it is likely to occur it must be 
shown in the job description. 



( 1,65 ) 



i 0.7/2 

This is done by the heading: - 

EXECUTION p.g SECONDS (or MINUOL^S or HOURS) 

where the time ectimate is this case is found by adding an upper limit for 
the tape waiting time to the COMPUTING- time. 

For example, if the program quoted in iO.y.l above was expected to 
be held up at most 200 times the job description \70uld include :- 

COMPUTING- 7.5 SECOI€)S 

EXECUTION 20. S SECONDS 
If the EXECUTION section is omitted for the job description the execution 
time is taken to be the same as the computing time. 
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10,8 Store Allooation 

An estimate of the amo"unt of store needed by the program is also 
required by Atlas to prevent a faulty program from monopolising the store 
by producing a large amount of useless infonnation. This is done by the 
job description entry 

STORE s BLOCKS 

nrVtA-rha o T <n + vi^Q Tn oyiT mim J;!' '•"ii^ Q j» of 5*12 fTOrd bloclcs ussd b"''' the "f^rcrsffii at an"^ 
one time. No distinction is made betvreen core and drum store. The word 
"BLOCKS" may be omitted if desiredt 

This section may be omitted, if the store requirement is less than 
32 blocks, in which case 32 blocks vfill be allocated and charged for. If 
the estimate for store is exceeded at any time the program is stopped by 
the computer. One extra block should be allowed for each input and output 
stream. The blocks usecL by the compiler are not counted unless the com- 
puter is retained in the main store after the program is entered. 
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10,9 Job Desoription Foniiat 

10.9.1 Order of Sections 

Separate sections of the job desoription may be listed in any order. 
For instance the OUTPUT section could precede the INPUT section, STORE 
could be followed by COMPUTING-, Hovrever, to make it easier to read it is 
perhaps advisable to keep to a fixed order, for example the order in which 
the sections have been introduced. That is:- 

INFUT 

OUTPUT 

MA&Ni-TIC TAPES (this is not an actual section heading 

DECKS 

COIlPUTING 

EXECUTION 

STORE 

10.9.2 Case Changes 

Throughout this chapter the sections of the job description have 
been written in capital or upper case letters since these are common to 
all forms of input. Changes of case are ignoi^ed however, and if the job 
description is on seven-hole tape, lower case letters could be used well, 

10,9,2 Backspace 

Throughout the job description 'backspace' is an illegal character. 



( 1.65 ) 



iO.-lo/i 



iO.-IO Composite Documents 

iO.iO.i Job Description Combined v/ith Program 

A job description may be combined with a program to form one com-^ 
posite document. In this case the last item of the job description will be 
followed, not by an end of tape majrker (-'^-^^'^Z) but by the program he-dins:- 

COIiPIIiSE. (Program Laii^ua^^e) 

and then by the program itself. No further title will oe necessary siiv-c 
the composite document takes the title of the job description, ihis vi:.,. 
be the usual form taken be small programs which are only run once. 

If this procedure is adopted, no input zero is mentioned in the IKFUT 
section of the job description and tiis cor.-.puter v/ill compile and execute 
the program immediately folic vving the job description. If there are no 
separate data documents the IKPUT section may be omitted completely. 



The examples given below illustrate these facilities. 



Example i 



JOB j 

FI96, J. BLOGGS: rWiuBER FREQIENCY ! 

i 
Il^UT i 

i ?1 96-TABULAT'iD Di!5?A 

CLTPUT 

LIl^IE PRIN'rSR 

GO:.:?ILER ABL 



Job Description^/program 



j DATA 

I F! 96-TABULATSD DATA 



**:':2 



Data Document 



In this example the job required one other data document so the 
INPUT section must be included. 

Example 2 



JOB 



F524/i, W. 3R01N, ]?EKRi\irai: PRJlviE NUI'/iEERS 



OUTPUT 

Lirc] PRiKT;3a 

i CARDS 2 BLOCKS 
CCK'IPILER ABL 



"'Z 
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Here no further information is required and the INPUT section has 
been omitted. 

iO,iO,2 Job Description Combined with Data Document 

It is also possible to combine the job description with a data 
document. This is particularly useful when the same program is to be run 
more than once, using different data each time. In this case the INPUT 
section of the job description must include: - 

SEHF = n 

where n is the programmer's number for the data which follows on the same 
document. The program itself is specified as the lowest numbered input 
stream, in the same way as when the job d&soription is a separate duoument, 
and the last item of the job description is followed by the heading 

DATA 
and then the data itself. No title is needed to identify the data, 

For example, consider a wage calculation carried out each month 
using one fixed set of data, say a list of P.A.Y.i], codes and a second set 
of data consisting of a list of hours worked by each member of the staff. 
The second set of data would, of coarse, varj- from month to month and could 
be oombined with the job description while using the same program and P,A,Y,E, 
code tapes. 

The program and data documents vfould be:- 



r CO"::':PILiai ABL 

F900, MG^i] CALCULATION 



(Program) 




The job description could then be combined with the second data document 
thus:- 



JOB i 
F900, J. SI'IITH LTD: WAGES OCTOBEE. i964 ! 

INPUT j 

F900, WAGE Ci\LGULATION 

1 F900, P.A.Y.S. CODES | 
SELF = 2 i 

OUTPUT 1 

LINE PRINTER 50000 LINES j 

i CARDS 2000 LINES j 

DATA 



(Data) 
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10,-10,3 Data PJJ.es 



It may "bo oaoier, for the purposes of some programs^ to treat several 

d.istinot ■na.ner ta^^es or stanlcs of card-s -2. a sin^'le d.'^t" ''^'^<->■'^-"o■^Tf- ' £'''"^h. 

a coiabination is called a data file. Each separate document is given a modi- 
fied data heading of the form 

DATA/m 

where m is the number of the document vd.thin the file, TJl documents com- 
posxng "the I xie nave Dhe same title and each is onaeo. oy a ""'"'' /j ena— Oi — uape 
marker, or a 7, 8 card punching. The last member of such a series must 
have the heading :- 

DATVei EW 

These documents may then be fed to the computer in any order and on any pei*i~ 
pherals and the computer v/ill combine them as required. In the IHFUT section 
of the job description they will be referred to as one document v:ith the 
title v;hich each of them bears. 

For example, if the data called U2i , IRON COIvlTEIfi: is on tv;o distinct 
paper tapes these may be headed as follows;- 



|Di\IDA/i 

I U2i , lEON COIXTTEI^IT 



(First part 
of data) 



''•''-'-Z 



1)12:^2 EM) 

U21, IRON coktim: 



( Second part 
of data) 



If the programmer wishes to refer to the file as input "bwo the INPUT section 
of the job description will contain: - 

2 U21 , IRON COI^iTELlT 



( i.65 ) 



10,11 Tape and Card Markers 

So far in this chapter only the marker ***Z and the 7, 8 punching 
have been considered as an end to a dociment. These are in fact the most 
oommon markers but there are others y/hich are dealt with below. 

On pimched tape all the markers consist of *** followed by a single 
letter. On cards *** is not acceptable, and is replaced by punching the 
7 and 8 positions in the first column of the card and the letter in the last 
column. The other 78 columns can contain anything at all. If the last 
column is blank, 7, 8C is assumed. 



10.11.1 The Tape Markers "^'^'Z^ C, T and A, 



a) ***z indicates not only the end of a document but effectively 
also the physical end of the tape. The peripheral equipment 
concerned is disengaged by the computer and when re-engaged by 
the operator a nev/ document will be read. 

b) ***c indicates that the end of the current document has been 
reached but that another follows on the same paper tape. The 
end of the doc-ument is noted by the computer and leading is con- 
tinued for the next document v/ithout interruption, 

c) ''"^T indicates a temporary stop, Vi/hen this marker is encountered 
the peripheral equipment is disengaged by the computer and when 
next engaged by the operator a continuation of the same document 
is read. Thus, if a document consists of two tapes the first 
part can be ended with a **--'T, V/hen this has been fed to the com- 
puter the second part is read by the same peripheral with no doc- 
ument heading and the computer v/ill treat the two parts as one 
document. 

If the document is data it is b etter to use the data file system 
given in 10,10,5 since the parts may then be fed to the computer 
in any order, on any peripheral, 

cL) *w*^^ j_g used only by a machine operator and is an instruction 
to the computer to abandon the previous incomplete document and 
disengage the equipment. It is required if part of a document 
is damaged b ef ore input is complete and the operator requires 
the computer to disregard the information it has already re- 
ceived, 

10,11.2 The Binary Tape Markers ^'^'^B, E and F 

Each of these markers indicates that a binary tape follows. 

a) ***B. \7hen this marker is encountered the computer reads the in- 
formation f ollov;ing on the same document in binary, instead of 
internal code, to the physical end of the tape. There is no test 
for end of tape markers. The last 2 or 4 characters from a paper 
tape read in this fashion will be overwritten in the store by the 
12 bit character 0707 (octal), which replaces any spuidous char- 
acters generated as the end of the tape passes through the rea- 
der (this does not apply to punched caixis). 



( 1.65 ) 



i0.1i/2 

b) -'"■"■F oauses the mechanism to he disengaged. When it is next 
engaged by the operator the new paper tape is read to its phy- 
sical end in binary. Thus "'''''•'? combines the effects of *'^'''T 

and '-•"•' '-'B, 

o) '••**£ causes the input follov/ing on the same tape to be read in 
binary but a check is made for ''''-'''A, Z or C. '\?hen one of these 
is encountered, binary reading, ceases and the appropriate action 
is taken. If the end of a reel of tape is encountered after -—''E 
and before an'^'' of these '''■■"'' secuences- the la,st 2 or 4- characters 
on the tape will be denoted by the 12 bit character 0707 (octal); 
the ne:rt tape will then be read as a continuation of the same 
binary document. Mien *'''*a, Z or G is encountered, it is itse3jf 
stored in binary. On cards follov/ing 7,8E a ca27d bearing 7,8A, 
Z or C is also stored in binary. 

Note that if it is required to reed to the physical end of a 7-track 
tape it is necessary to precede the "'■•■'•'B, S or F by ■■'■-"•'p^ as described be- 
low. If this is not done the tape may be rejected because of a spurious tape 

j^cU.j.uj J. d,i-4.JL u viiii^ij. OXJ.U cXiu. ui i»ca,jjc paoL>i;io i/iix vjug,ii one uttj^c j. fcau.cX • 

The marker ■-•■••"•'B can also be used to read a fixed number of characters 
in binary'-. This is done by prefixing the marker by '-'n thus:- 

*n-='^-B 

7/here n is the number of characters to be read, "'.Tien the n tape or card 
characters have been read and stored, reading continues in internal code. 

Vfhen reading pionched cards an alternative way of causint, the card 
to be read in binary is available. If the first column of a card is a stan- 
dard code the contents of the card are converted to internal code. ±j. ti^e 
first column is not a standard code the card is assijoned to be in binary and 
is stored as such. Naturally, after a 7,8 B, E or F has been read all cards 
are t aken as binary regardless of' their first column. 

iO.ii.S The Tape Mark er '^"''"T 

\7hen reading 7- track paper tape in internal code or in binary the 
Supervisor normally checks the parity of each chara,cter (an odd number of 

holes for correct_p,arity) and rejects the. document ^if, a character with w3X)ng 

parity (blank tape for example) is encountered. This paritj- checking may 
be suppressed by punching *■•''•'••?, but it -yvill be restored again at the end of 
the given document. If the input is binary and '•■'■'-'-'p has been punched, wrong 
parity characters will be recorded as punched, but if the input is interr^al 
code they will be replaced by the fault character 7.7 (inner set). 

Note that to suppress parity checking on binary input it is neces- 
sary for *'^'''p to appear before '•"•"•'B, S or F; =•'■=••■? after =-'-''''''B, E or F will 
not be recognised. 

i 0.1 1,4 Card Markers 

The same markers are available for use v/ith cards, but with ''''•■''•' re- 
placed by a 7,8 punching in the first column of the card and with the letter 
in the last column. 
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10,12 Input and Output using Private Magnetic Tapes 

All the documents fed to peripherals for input are stored by the 
computer on a magnetic tape knovm as the system input tape. They are then 
brought into the core store as required* If a program has a large amount of 
input it may be in the programmer's interest, and in the interest of the 
eff icieiK)y of the computer, to transfer this input to a private tape before 
starting his progrtim, instead of using the system input tape. 

Output is nonnally accumulated on the system output tape before 
being sent to the required peripherals. If a pixjgram involves extensive 
output this may be \vritten to a private magnetic tape instead, and later 
output upon requesting the Supervisor to do so oy means of a special docu- 
ment fed in through one of the peripherals after the ^b is complete. 

Both these facilities are dealt with in this section. 

10.12.1 Extensive Input 

A document can be copied to a NEViT magnetic tape by putting above 
the document heading the directive :- 

COPY TAPS NEiy 

*tape number tape title 

The title specified v/ill be widtten in section of the new tape 
and the document following will be copied into section 1 onwards. 

If it is required to store the document on a previously used tape 
(i.e. one which already has a title) the necessary heading is:- 

GOPY TAPE b 

*tape number tape title 

Here b is the nuuber of the tape block at v/hich it is intended to 
begin copying the input* 

When the copying process is complete the follov/ing information will 
be printed by the computer :- 

*tape serial number/seotioiy'word 
title document. 

The section and v;ord indicate v/here the document is stored. 

Ebcample ; 

To copy the first data document of the job given in 10,6 to 
the NEW tape P1111 it would be fed to the peripheral in the form;- 

COPY TAPE HEW 

*F1111 DATA FOR P64r, METALS 

DATA. 

F64/A, IRON G0NT:;3NT 

(data) 
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■•''Pi ii 1/1/0 

F64/a, iron COifTEI-JT 

The second data document could be sent to section 7 cnv;ard 
of the sane tape thus:- 

GOPY TiiPE 7 

*F-1111 DATA FOR F64i IuET-^l-S 

DATA 

P64/B, COPPZR GOIWEITT 



(data) 



This could produce the output :- 

*P1 11 1/7/0 

P64/B, COPPER CONTS^IT 

10.12.2 Job Description References 

In 02?der to use documents copied to private tape, "the tape nust 
appear in the tape section of the job description in the usual ^^'ay. In the 
INPUT section of the job description the sub-heading :« 

i TAPE a/b/o 

must appear before the title of the document. Here i is the input stream 
number, a is the programmer's number for the tape, b the block number, and 
c the woi*d number xirithin block b at which the document stai*ts» Thus the 
job description to run the program of 10.5 could begin: 

JOB 

F64, STATISTICAL ANALYSIS OF MiTTALS 

INPUT 

F64, ANALYSIS PROC-SAIvI 

1 TAPE 27/1/0 

.F64/A,.JIUmjC;iMCMi:.,.- _.--„.,- -,-.-- .-- - ..-_._.,.__,...„ 

2 Ti^PE 27/7/0 
F64/B, COPPER CO^TTENT 
OUTPUT 

n. T TTVT'^ TDD TT.lll! I, 'II 

1 FBTE HOLS PUInCH 3 BLOCKS 

TAPE 

27 *F1111 DATA FOR P64, METALS 

10.12.3 Re-use of .Documents on System Tapes 

As already explained, under normal circumstances documents are 
stored on system tapes before use. Arconf; the information on output will 
be the location of each document on tape. This will take the form:- 

Sa/b/o 
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where Sa is the system tape number, and Td,c are the block and vrord niimbers 
of the first word of the document. Such tapes will be stored for a fixed 
period of time and if a document is required again within this time it may- 
be called for direct from system tape, avoiding the use of a slow peripheral. 
This is done by including in the INPUT section 

i TAPE Sa/b/o 

Title of document 

where i is the programmer's number for the document. 

For example, if a progrcjn craied 'F74 FACTORIS/iTION' has been run 
and is stored at S7/2/411 it can be re-run with a data document called 
'F74 LIST 5A' by a job description as follows:- 

JOB 

F74 FACTORISaYTION RUN 2 

INPUT 

T.\PE S7/ 2/411 
F74 FACTORISATION 

1 F74 LIST 3A 
OUTPOT 

1 LINE PRINTER 

Oiily the job description and the data document woiild then need to 
be fed to peripherals. Note that no further reference to the system tape 
is required. 

10.1 2. 4. Extensive Output 

Large quantities of output may be written to a NE\7 magnetic tape 
by specifying in the OUTPUT section: - 

OUTPUT 

i TiiPE a/b/o 

type of equipment m BLOCKS 

Here, i is the output stream number, a the programmer's number for the tape, 
b the block number, and c the word number where the copying is to start. 
The last line is as in section 10. 4. 2, 

Thus if output 1 of the job in section 10.5 were 300 blocks instead 
of 3 the OUTPUT section could be written: - 

OUTPUT 

LIKE PRUCER 

1 Ti^E 27/1/0 

SEVEN HOLE PUNCH 300 BLOCKS 

The tape must be specified in the usual way in the tape section of the job 
description: - 

TiJ?E NEW 

27 *F1111 F64, OUTPUT METALS 

This will cause the NEV/ tape F1111 to be given the title 'F64, OUTPUT METALS' 
and the output to be sent to this tape beginning at block 1 • 
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If it is required to store the output on a previously used tape, 
the necessar^^ entry in the OUTPUT section is the same, "but the tape must 
be specified under the heading TAPE in the tape section. 

The private tape can be printed by a steering tape consisting of:- 

PRINT TAPE 

*tape serial number/tape title 

^ j> j.i_~ ^,_^_ J j_ a._ T J L._j 

II i^XiC 'filiKJJUC oci' 'C JLiD iA> UU UX'-Lii. L-tjQ. 

or 

PRINT T.^E b/c 

*tape serial number/tape title 

if one document is to be printed, from block b vrord c onwards. 
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10,13 Job Description Parameter 



In a job V7here different parts of a standard program are required 
to process different types of data, it may be more convenient if the data 
type is indicated in the job description rather than In the data or program, 
The parameter section in the job description provides for this, and is 
written in the form 

PARAIhETER 

*<number> 

The number consists of up to eight octal digits, and is loft Justified, 
PARAI':'ETSR and t he number may be on the same line, separated oy one or more 
spaces. 



Examples: 



PMAIiETER * 00061 247 
PMAIuETER > 



1 060 S alternative 

forms 
PARAIViETIilR *1 060000 ) 

..»-v--.- — w ^..^^ w^us^ w>^A uv*N^uj.wAx ayjjKicA^ o »»a.01i U OllCX" iSCUliXUllB, OIIG UlXier 

of sections is immaterial; if omitted, the parameter is taken to be zero. 

The value of the parameter nay be read by program using the in- 
struction 

1140 4 S 

which will set the half-word s' = parameter number (see section 12.9). 
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Ch apter ii 

MOiNiZrOIiING- AI 'ID FAULj. DEjISCTION 

ii,i Supervisor Monitoring 

Y^th the aid of special hardv/are, the Supervisor keeps a record of 
the progress of a prosram during its run. This supervisor monitoring notes 
amongst other things the store in use, the computing time taken, and the 
occT;r*renco of errors vrtiich may prevent the successful execution of the pro- 

gram« 

In Atlas, provision is made for the automatic detection of a 
variety of clearly defined f^tult conditions, ;Thich may be due either to 
mistakes in the program itself, or to errors occurring ir. the computer or 
the peripheral equipment. The faiolts result in entry to a part of the 
Supervisor laiovm 'as' the 'monitor' prog-roia, with the particular fault res- 
ponsible being distinguished by a mark or count set in 39i . 

The monitor pr05rL;ia consists of a set of routines, some in the fixei 
store ar^ some in the main store, v;hoGe primcx:^ piirpose is to print v_at --.r: ; 
information as vfill enable the cause of the fault to be diagnosed, ^n the 
case of certain tj^pes of progrsja faulu, it may be possible for the progrctTir-e:: 
to decide beforehand v;hat action should be taken to enable the prorrtum to be 
resximed; he will then provide a number of fault rcutines and list them in tb: 
trapping vector. The monitor program will enter the trrp^ indicated in E91 , 
if such indication does in fact correspond with an entry in the trapping 
vector; otherwise it will proceed to diagnostic printing, or will trjinsfer 
control to a private monitor routine ii* so requested. This private monitor 
program may provide a special form of diagnostic printijig - either instead 
of or in addition to the standard - and m.ay, once and once only, cause the 

j._ -u- ,, — ;3 ^v^-rT r.i-i><o.-./-ma-nH- mnnn+Dr'T'nr^ wtTT. ftlii-AVR be follovred 

by the End Prog-rain sequence, except xihen the fo.ult is trapped. 

Y»lien entry to the private monitor follows expiry of the total time 
allotted to the program, a further 4 seconds of computing time is al lowed 

for the compietionor the 'private' mon^^^^ ^Sim.cxlJT xf^ -exerrotion 

time is exceeded, a further minute of execution tixie is aJ.lowed, and if OKt- 
put is exceeded, a fiirther block is alloy/ed. 

ii.i.i Types of Program Faults 

Ife shall here concern outselves solely v/ith program faults: there 
is little that the ordinary programmer caji do about machine faults, other 
than to minimize their effect by providing adequate re-entry points and an 
informative private monitor routine. 

There are three distinguishable categories of fault detection 
causing entry to the monitor program:- 

(a)''lntermpt Faults-' Some faults are detected by special equipment pro- 
vided for the purpose: these incliode exponent overflow, division overflow. 
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use of an imassigned function code, and 'sacred violation (i.e» reference to a 
part of the store reserved by the Super*visor). An inteiYupt occ\irs and vriJLl 
set in B91 a digit corresponding to each such fault. Further analysis of the 
fault is provided by a supervisor extracode routine (S.E.R,), the same rou- 
tine being used for all faults. 

(b) 'Supevvisor Faults'^ A fiirther class of faults are detected by S.E.R.'s, 
being especially conoern*d with faulty use of the store and of peripheral 
equipments, and with the over- running of time allowances. These faults lead 
to the setting of an appropriate digit of B91 , just as if they had been de- 
tected by hardware, as in (a) above; they incli:ide over-running of computing 
time or of tape waiting time, and attempts to exceed the requested store 
allocation. In the object program, extracode instructions dealing v/ith the 
store and peripherals will enter a S.E.R. to detect faulty usage. Only one 
such fault can be detected at once, but it will be recorded as a count in 
B91 without interfering with any existing record of faults of the interrupt 
type. The same S.E.R. monitor sequence is entered as in (a) above. 

(c) *EostrcBOiOdB Faults^ Many faults are detected by the ordinary extracode 
routines themselves; typical of these are errors in the argianents of functions. 
Only one such fault can be detected at once; the extracode will set a counter 
in B91 and then jump directly to the common S.E.R. monitor sequence men- 
tioned above. 

The various faults which result in entry to the monitor program are 
listed in the table below: - 

FAULT TABLE 









MARK OR 


TRAP 






DETECTED 


COUNT 


NUMBER - 


FAULT 


MOKITOR PRUNING 


BY 


IN B91 


(IF ANT) 


Local time expired 


L TBiE EXCf'IKDSD 


S 


Bit 5 





Division Overflow 


DI\^ OVERFLOW 


I 


Bit 6 


1 


Exponent Overflow 


EXP OYEBFLO^i 


I 


Bit i4 


2 


Page locked down 


PAGE LOCKED DOWN 


S 


Bit 1 


S 


Number of blocks 
exceeded 


EXCESS BLOCKS 


s 


2.0 


4 


Square root argu- 
ment < 


SORT -VE AR& 


E 


2.4 


5 


Logarithm argument 


LOG- -VE ARG 


E 


3.0 


6 


SPARE 








7 


Inverse trig, 
function 


INVERSE TRIG OUT 
OF RANGE 


E 


4.0 


8 


Reading after 
Input Ended 


INPUT ENDED 


s 


4.4 


9 


End of Magnetic 
tape 


END TAPE 


S 


5.0 


10 
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FAULT 

Variable length 
reco2?d error 

Magnetic Tape 
failures 

Computer failures 

Unas signed Fimction 

Sacred Violation 
Instruction 

Sacred Violation 
Operand 

Illegal block 
number 

Band not reserved 

Computing time 
expired 

Execution time 
expired 

Input not defined 

Output not defined 

Output exceeded 

Tape not defined 

Illegal search 

No selected tape 

No mode defined or 
attempt to write 
when not permitted 

Number of decks 
exceeded 

No trap set 



MONITOR PEINTING- 
V TAPS ERUOR 

TAPE FAIL 

COMPUTER FAIL 
ILLEG-AL FUNCTION 

SV INSTRUCTION 

SV OPERAND 

ILLEGAL BLOCK 
BAND NOT RESERVED 
C TIME EXCEEDED 

E TD,1E EXCEEDED 

INPUT NOT DEFINED 
OUTPUT NOT DEFINED 
OUTPUT EXCEEDED 
TAPE NOT DEFINED 
ILLEG-AL SEARCH 
NO TAPE SELECTED 

mONG- TAPE MODE 



DETECTED 
BY 

E 



Number of branches 
exceeded 



S 

S 
S 

s 
s 
s 



ivIARJC OR 
COUNT 
IN B91 

6.0 

6.4 
Bit 4 

Bit 8 

Bit iO 

9.6 
10.2 
Bit 2 

Bit 5 

ii.6 
-12.2 
12.6 
15,2 
i3.6 
14.2 

14.6 



EXCESS BRANCHES 

(1=: Interrupt ; E = 

Some of these faults are associated with 
description, and are listed helow. 

Excess Blocks 

Computing Time exceeded 

Execution Time exceeded 

Input not defined 

Output not defir^d 

Output exceeded 



TRAP 
NUMBER 
(IF- ANY) 

11 

12 
13 



EXCESS DECKS S 15.2 

TRAP UNSET S 15.6 

S 16.2 
Extracode; S=S.E.R. ) 

information in the job 
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Tape not defined 
Excess Decks 

Division overflow occurs with ceiijain division instructions, marked 
DO, when the divisor is zero or substandard* 

Exponent overflow occurs with certain instructions, marked E, when, 
after completing all functions of the instruction, including rounding and 
standardisation, the accumulator exponent is greater than +i27» The guard 
and sign bits of b1 24 vdLll be and i respectively. If exponent overflow 
is trapped, the fault indication will not be reset and may cause further 
monitoring with a subsequent accumulator operation. This may be avoided by 
first clearing B124, setting guaird and sign bits to zero. If the accumulator 
exponent becomes less than -128 during multiplication, division or standardi- 
sation, then the guard and sign bits of b124 are 1 and respectively. This 
is exponent underflow. The accumulator is set to floating point zero, but no 
fault is indicated. 

The arguments for square 370ot, logarithmic and inverse trigonometric 
functions are all tested to determine whether they are within range. They 
may cause exponent overflow if very large arguments are used. 

Programs that employ line reconstruction, such as the ABL compiler 
and LI 00, will attempt to read after the input stream is finished if the end 
of document marker *'*'*Z etc, occurs on the same line as the last information 
for the program. 

Sacred Violation Instruction refers to a transfer of control to 
address J5 or above. If control is transferred to the fixed store, between 
J4 and J5, there is no immediate interrupt, but the result is unpredictable. 

Sacred Violation Operand alvfays meana an attempt to read or write 
to the private store (i.e. to J5 or above). 

Illegal block niimber indicates a reference to the Supervisor working 
store, between J54 and J4. 

Certain functions are detected as being illegal. The instruction 

1000 

which is the same as floating point zero, causes entry to extracode control 
to attempt to obey the instruction 

001 

or the floating point number ^. This function is recognised as being Un- 
as signed. 

End of magnetic tape refers to an attempt to obey a transfer in- 
struction involving section 0, or to use tape beyond the last addressed 
section (section 4999 on a fully addressed 3600 ft, tape). 

Illegal search refers to an attempt to search a magnetic tape for 
section or beyond the last addressed section. 
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No magnetic tape selected indicates that none of the 'select tape' 
extracodes has been obeyed* 

Variable length record error implies an attempt to transfer when not 
aligned on a tape marker, or an encounter with an incorrectly made marker. 

Should a magnetic tape failure occur, the program may not be moni- 
tored immediately, and in this case an attempt v/ill be made, by the Supervisor, 
to produce a correct transfer. After a set nimber of failures, usually seven, 

not previously been written to \7ill be recognised as a tape failure, and hence 
it is advisable to vo^ite to all sections required iThen a new tape is used. A 
decimal number may follov/ the TAPE FAIL text, and this is interpreted as 

8192A + 512B + C 

where C is the tape number on which the failure occurred 

B is the fault number 

and A is che fault type, if E-tj^'pe, 1 if P-type, 

These faiilt types are described in the Atlas 1 Computer System Operators' 
Manual. 

A monitor for 'Trap Unset' indicates an attempt to enter a trap using 
extracode 1134 when no tape has been set by extracode 1132 (see section 11.2). 

An attempt to exceed the mmber of active branches specified by ex- 
tracode 1103 will be monitored (see Chapter 12). 

'Page Locked Dovm' and 'Band Not Defined' monitoring may occur when 
a program is controlling transfers betvreen tlie drum and core store (see 
Chapter 12). 

11.1.2 Standard Post Mortem 

Following the detection of one or more of the faults listed above, 
the appropriate text will normally be printed on Output 0, followed by a 
standard form of post mortem printing, similar to that shown below. 

BMD NOT RESERVED 



H^'STR 73 


121,127,0 ,549 B127=: 




INSTR 74 


1177,0 ,12 , B12 = 4. 


6 


INSTR 75 


101,13 ,12 , 108.4 B13 =-1048574.6 B12=4,6 


B1 ^699050.6 


B2 =^1031932 B3 = 42798,7 


B4 =^42799 


B5 =-0.1 


B6 =^258553 BIO = 18 


B1 2 = 4. 6 


B1 3 =-1048574. 6 


B70= 0*6 B80= 0,1 


B90 = 36 


B91 = 10.3 


B92 = 0.1 B93 = 0.1 


B94 = 7.1 


B95 = 265.1 


B96 =^0. 3 B97 = 91 7504. 4 




TAPE 1 


AT 64 




TAPE 2 


AT 72/306 




TAPE 3 


AT 1 





Nonnally the current address in main control, B127, is printed, fol- 
lowed by its full word contents in instruction form, and the contents of any 
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B-lines in the range Bl to B99 referred to, imless ze]?o. Irrespective of their 
true value, the contents of any B-lines in the range Bi00-B127 referred to will 
be printed as zero. The tv/o previous words are similarly printed. If one of 
the locations is in the private store or is undefined, then 

INSTR UNALLOCATED 

will be printed instead of the normal form. Following an EXCESS BLOCKS fault, 
b1 27 will be reduced by 1 bef 02?e printing instructions. The instructions 
printed may not be the last three obeyed, as a jump may have occuired to either 
the second or third instruction printed, as must have happened in the e2Qample, 
Also, because of the overlap in executing instructions with each other, and 
with other operations such as tape transfers, the printing may occasionally 
bear little relation to the instruction originally causing the fault, although 
many extracodes causing faults V7ill appear as the second instruction; basic 
functions causing faults may appear as cmj one of the three instructions, or 
not at all. 

iifter the three instructions, the contents of all B-lines Bi-B99 are 
printed, unless zero. 

If one inch magnetic tapes are being used, their current positions 
are then printed out, indicating the next section nimber, and, for variable 
length working, the word number olso. 

Except for the function codes, which have tlieir usuaa. xorm, anu. 
octal fractions in addresses and B-lines, all numbers are decimal, 

11,1,3 Ending a Program 

If no fault is found during the execution of a program, then the run 
will be finished by obeying the 1117 extracode. If a fault is found, then, 
after post mortem printing, the Supervisor will normoJJLy end the run as if the 
1117 instruction had been obeyed^ 

1117 Print monitoring information on output 0, End ell program output 
streams, indicating the amount of output in each stream. Instruct 
the operators to disengage and rewind all magnetic tapes used. 
Remove the job from the store j clear Supervisor directories relating 
to this job. 

The form of the monitoring information on output is given below, 

<Job Title> 
INSTRUCTION 8 7 
STORE 32/4 

2 DECKS 6 T/iPS BLOCKS 1 HALT TH-.S 
INPUT ■ 1 BLOCI^ 
OUTPUT (3) Al'IY 40 R'XORDS 

The meaning of this information is explained below, 
INSTRUCTION 8 7 

8 instruction interrupts wore obeyed in all, of which 7 were used 
in compiling. An instruction interrupt occurs every 2048 instructions, basic 
multiplication and division orders being counted as 2 and 4 instructions res- 
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pectively. At some installations a third number on this line gives the number 
of program blocks transferred between drum and core store, 

STORE 52 / 4 

The job description requested 52 blocks of store, of vrfiich 4 blocks 
were in use v/hen the program was teraiinated, including one block for each 
input or output stream, 

2 DECKS 6 TAPE BLOCKS i HALT TBIE 

Two magnetic tape decks v/ere reserved, and six blocks were trans- 
ferred between tape and main store. The program was suspended by the Super- 
visor for one second avj-aiting the completion of tape transfers, 

INPUT -1 BLOCKS 

One block v/as needed in the input well to hold the information on 
input stream 0. There will b e similar printing for all other input streams 
defined, 

(5) ANY 40 






The job description requested that output stream should be to 
MH type of peripheral. Forty records were output before the program was 
temiinated. if the actusl peripheral is a paper tgpe punch, the output will 
be measured in blocks? otherwise, in records. The output stream was broken 
into three parts; this printing is suppressed if the stream was not broken. 
There will be similar printing for all other output streams defined • 

The amount of output, indicated at the end of each stream, is always 
measured in blocks, in the form 

El© OUTPm: i BLOCKS 
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11.2 The Trapping Vector 



Upon entry following a fault, the first action taken by the monitor 
program is a check to see if the fault has been trapped by the programmer; 
if so, the monitor sequence will at once exit to the trap set. 

The trapping vector occupies several successive words of the store, 
and the address of the first word must be specified as S in the extracode 1132. 
Each word holds the trapping infomation for a particular fault, word n being 
associated with fault type n; the more- significant half-word contains the 
address of the fault routine to which the trap will trttnsfer control, and the 
less- significant half-word contains, in bits 15-21, the address of a B regis- 
ter which is used to hold the value of main control v/hen the fault was detected. 
This may be but is not necessarily the point in the main program at which the 
fault occurred. 

Only son« of the faults listed in the table in section 11.1.1 have 
trap numbers: these are the faults which tho programmer might reasonably be 
expected to deal with before resuming the program; certain traps may be use- 
ful as a means of avoiding extra testing in the program. There are faults which 
are not trappable; these include such faults as sacred violation, which the pro- 
grammer can be expected to avoid, and deviations from the job description, in 
exceeding the specified time allowance, for instance. 

No trapping will occur unless the program first obeys an 1132 in- 
struction, specif 3dLng the address of a trap vector. Subsequently, trapping 
can be suspended by specifying a negative address in extracode 1132. In order 
to trap some faults but not others, the programmer should specify a negative 
jump address in each unwanted trap. Normally the trap vector will be punched 
as part of the program, and the unwanted entries may be punched as 4O or merely 
omitted, since floating-point zeixD produces a negative first half-vrord, because 
its exponent is -128* 



below. 



Two other extracode s associated with the trapping vector are given 



1133 Place the first address of the trapping vector, if any, in Ba; if 

no trap has been set, make ba negative. This enables a sub2X)utine to 
preserve the current trap when a private trapping vector is reqviired. 

1134 Obey the entry number Ba in the trapping vector, as though a fault 
of type Ba had occurred. Ba may rcjige from to 63 inclusive, and 
may be used to enter standard traps, or as a subroutine entry at 
addresses listed in the trapping vector for 'fault' numbers 14 
onwards. 
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1 i . 3 Private Monitoring 



When the monitor program encounters a fault which is not trapped, 
it prepares to terminate the program and proceed to diagnostic printing, as 
described earliei;'* If he so desires, the programmer may suppOy a private 
monitor sequence, whose starting address must he specified hy \ising extra- 
code 11 -1 2, The last octal digit of the starting address determines the tiine 
of entry to the private monitor as follows :- 



U' 



ctal Fraction Sntiy 

1 Before printing the one line explanatory 
text 

After printing the text 

2 After the standard post mortem printing 

V/hen the entry is before any printing, B91 contains the record of 
faxiLts, and B92 the value of main control when the fault was detected, with 
the contents of B93 and 3121 altered. Otherwise B96 and B97 will also be 
altered. 

In the event of faiilts in the private monitor sequence itself, it is 
necessary to avoid the possibility of endless loops of errors; this is accom- 
plished by forbidding a second entry to the private monitor. Any subsequent 
faults may be trapped, but if they are not trapped the standard monitor will 
end the program. 

Specifying a negative address with extracode 1112 cancels any 
private monitor routine. 
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11 •4 Restarting and Re"entering a program 

Followijig a failure in the computer or an onr-line peripheral, jobs 
completely in the machine will not be lost, although documents of incomplete 
jobs, and documents only partially read must be input again. Programs par- 
tially executed will normally be restarted from the beginning; -there are no 
facilities at present by which the Supervisor will dump program information to 
allow re-entary to a point other than the start of a program, 

11 •4,1 Preventing a Restart 

It may be useful to prevent a job using the 'break output' facility 

from being restarted once a point is reached where the job is siibstantially 

complete; alternatively a restart may be impracticable for a job using 
magnetic tape* To this end, the instruction 

1115 0-1 

will prevent the job being restarted if a breakdown occurs foUov/ing the use 
of the extracode, but before completion of execution, 

1 1 , 4, 2 Re-entering a Program 

After a breaMown, for a program to be re-entered at some point other 
than its start, it is normally necessary to dump information as the job pro- 
ceeds, specifying a re-entry point with each dimipi. Although the Supervisor 
does not yet provide such facilities, the programmer may provide his own dump 
routine* 

Such a routine, called Dumpling, is described in the I.CT. Atlas 
Computing Service Bulletin No. 7, Dumpling occupies one main store block, 
dumping, on to magnetic tape, the information listed below: - 

All defined store blocks, including Dumpling, 

The tape numbers and positions of all one inch magnetic tapes vvorking 
in fixed length mode. 

The accumulator (double length) 

The logical accuijiiilator 

B-lines 1 to 90, and B121 

The nimber of the cxirrently selected input stream. 

The number of the currently selected output streant, 

V-store line 6 containing AO, Bt, Be, etc. 

The address of the trapping vector, if any. 

Details of the dump region. 

The d\amp nxMbei*, 

The re-entry point to the program in the event of a breakdown. 

As each dump is made, its location is printed on output stream 0, 

After a breakdown, a very short steering program allows the infor- 
mation stored at the last or the penultimate dump to be recovered, and the 
program continues from the corresponding re-entry point, 
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1i,5 Monitor Exbracodes 

The monitor extraoodes introduced earlier are listed again here. 

Hi 2 Set the address of the private monitor routine to S, If the standard 
monitor program is subsequently entered, following a fault which is 
not trapped, control v/ill be transferred to the pidvate monitor, 
possibly after some diagnostic printing. The amount of diagnostic 
printing is determined by the octal fraction of S, as follows: 

Octal fraction Pi-int-out 

One line describing the fault, 

i No standard printing, 

2 One line describing the fault, followed 

by standard post i-iortem print-out. 

To subsequently suspend private monitoring, a negative address, S, 
must be used with 1112. 

ii13 -i Do not restart. 

If a breakdown occurs after obeying this instruction but before the 
job is completed, it will not be restarted, 

1117 ]3nd program 

Print monitoring information on output 0; end all output streams. 
Instruct the operators to disengage and rewind any magnetic tapes 
used. Clear all Supervisor references to this job, 

1132 Set the address of the trapping vector to S. 

ThJ-s extracode must be obeyed be^fore any trapping oan take place; to 
subsequently suspend trapping, 1152 must be used again, but this time 
with S negative, 

1133 Find address of trapping vector, 
otherwise set ba' negative. 

1134 Enter trap Ba:. (0<Ba<63) 

Obey entry number Ba in the trapping vector, as though a fault of 
type Ba had occurred. 
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1i«6 Faults Detected by the Compiler 

Apart from faults detected during the execution of the program, 
many types of error may be found earlier by the ABL compiler. An indication 
of the type and location of er.ch fault is printed out on the current output 
stream, usually output 0, and, if necessary, arbitrary values are assigned 
to expressions to allow compiling to continue. 

There are some special preset parameters v/hich determine the.exs.ct 
action taken by the compiler after a fault has b,.-en found. These parameters 
are described in Chapter I2j the compiler action described in this section 
assumes no program setting of these parameters. In particular. P1 10 will 
normally be zero, 

•1-1.6,i B-lines in ABL 

It may be useful to know whether a inin has ended during compiling 
or execution, ^Vhen ABL is in operation, B3 is in the range -127 to in- 
clusive. The most likely value is -127, imless the run has been terminated 
by INPUT EM)ED, 

ABL uses most of the B-lines, It preserves its ov/n B-lines when it 
meets an enter directive, and then clears B1 - B68 before obeying the 
directive, B89 v^dll contain the current value of *, After an E-directive, 
B90 contains J5; after ER or EX, B90 is clear, 

11,6,2 Indeterminate Items 

When ABL needs to evaluate an expression, and can not do so, the 
expression is faulted as described "bslow, and an arbitrary value assigned. 
The value depends on the context, 

(i) ''' = expression . When this is faulted, * is given the value 

604;i21P110 or 654321. 1P1 10, This allows ABL to tiy to check the 
rest of the program, although it naj'- not be able to enter it, 

(ii) In all other oases the expression is given the value J56, If the 
expression is in an Enter diivsctive, it will cause a monitor on 
ILLECAL BLOCK, since J56 is an address in the Supervisor Working 
Store, A similar monitor is lilcely if the expression occurs in an 
instruction which is subsequently obeyed. 

WTien any other faulty item is found, nothing is compiled. As the 
store is initially cleared to floating point zero, all or part of this bit 
pattern will remain in the location reserved for the faulty item, 

''^•^•^ P^Q-gJ^ostic Printing 

The first ABL diagnostic printing for a program is preceded by the 
line of printing, 

ABL MONITORING- 

Each fault causes printing, on a nev/ line, of the location of the 
fault within the progrcm, together with an explanatory text. The following 
line will usually be a 2?econstruction of the line of program containing the 
fault. 
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If the error density is higher than 8 faults in 24 lines of prdjat- 
out, then 

TOO MAN! ERRORS 

is printed, and the rim ended (see also Pi 01), Blank lines ^ and lines 
containing only erases, are ignored. 

Normally, when a fault is found, compiling continues until an E or 
ER type of enter directive is encountered, so that any further faults may he 
detected, When the enter directive is reached after one or more faults, 

ERRORS DO NOT ENTER 
is printed, and the jcvxi ended (see also Pi 02), 

1 1 , 6, 4 Fault Location 

Each ABL monitor printing begins with a specification of 'where 
in the program the offending item occurs, 'l,^ere' means 'in what line of 
the printed program and in what part of that line'. ABL refers to lines 
of print in exactly the same way as a prograimner does hy counting from the 
last label set, but with the exception that AO is not used to mean the line 
on which the first instruction or item of a routine appears but the line in 
which the R itself appears. Thus the very first line of print in a program 
is 1 AO/O. Blank lines, and lines containing only erases, are ignored. 

IThen ABL prints 3,4 Al/20 it means that it has read 3 terminators 
in line 4 after A1 of routine 20 v/hen it has found an error. Thus, for 
example, if an expression is incomplete (e.g., no close bracket after an 
open bracket), then the next terminator will have been encountered before 
ABL can realise that there is an error, and the 'position along the line' 
will be printed accordingly; but, if a bogus character is found in an 
expression, then this will be recognized before the next terniinator is 
encountered. 
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11.6.5 Diagnostic Printing Character Set 

In all diagnostic printing, ABL uses its own character set. The 
following is a list of all available external characters (7-track tape, 
5-track tape, and cards) .end their corresponding ABL characters. All the 
ABL characters are contained "in the 7-track tape and Anelex line-printer 
character sets, so that ABL diagnostic printing may alwao^'s be completely 
printed or punched on these media. 

External: 01 25456789 
ABL : 0123456789 

External: A B C D 3 F G H I J K L 11 N P Q R S T U V W X Y Z 
ABL : A B C D 3 F G- H 1 J K L M N P Q R S T U V W X Y Z 

External: abcdefghijklmnopqrstuvwxyss 
ABL : A B C D E P & H 1 J K o<U NOPQRSTUVWXYZ 

External: ^ f ly- p ,+-:'£!<>= ,(}?aw& 
ABL • P /-^p • +- • ' L J < >=^* ( ) ^^^1 ^^ 

External: * 10 11 ^£ ^ v^^> -> x ^ n 
ABL : * ^-"v »< r^ I c><okc<o t?cvxcx' 

411 o'^'^e"''* c-1 TM-ji_/a i^V\r-.-r*rxQ-¥Qy>c ri vg 2^(2T-iT_o/>g^ V)Tr-^^ . Ai "i ooffi'oosite 
characters not including Erase are replaced by p^ All composite characters 
including Erase are ignoi^sd. All single spaces are ig-nored. Two consecu- 
tive spaces are replaced by Comma. After a Terminator all spaces are ignored^ 
but not commas (see fault belov^), 

1 (low'cr case L) is an illegal character, unlike the rest of the 
lower case alphabet; i and o are treated as one and zero respectively, as 
are capital I and 0. 

1 1 . 6. 6 Explanatory Texts 

The ABL texts are listed below, with flirther e:q)lanation v^here 
necessary. 

INSTRUCTION? 

ABL thinks that a line contains an instruction, but something is 
incorrect with the format, i.e, a line begins with a number (un- 
signed), and does not have four parts. 

OCTAL NO. CONTAINS 8/9 

IRREGULAR FUNCTION 

ABL thinks that a line contains an instruction, and its first part 
has not been f aiilted by either of the tvro preceding monitors, but 
contains either more than 4 digits, or four with the first equal 
to 2 or more. 

WRONG FOmL\T 

A line contains items which ccjinot be identified; whatever kind 
of items they are meant to be, something is wrong. 
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NOT TZSIvIINiVTED 

A character which has no meaning in the current context is en- 
countered within an item, "l/hen this occurs, ABL skips to the 
next terminatoT- 

ACCUMULAIOR 0V:3EPL0W 

Fixed-Point Overflow is caused in the Accumulator as a result of 
any arithmetic process required because of the fona of any item. 
In practice, this can only occur during the 'de-standardising' 



■•J 



lit . .1 -m _ x.± T-v- J . L T,T. T J> „ . J 



a(b):d, a(b:c):d, and a(;c):d, 
SHIFT >25 PLACES Requested by a U or a D operator. 

HviPERIvIISSIBLE + 

Z in RO 

* OUT OF RAN&E 

An attempt is made to compile an item into store with the trans- 
fer address (*-Pi10) greater than or equal to J3, or less than 0. 
Compiling will continue from *=:654321,i +PiiO in an attempt to 
detect any other faults. 

PARAMETER OR ROUTII^ NO. TOO BIG 

A parameter, routine, or copy nuip.ber is greater than the permitted 

highest value, that is 
(i) if a reference is made to a routine nmber greater than 3999 
(ii) if a routine parameter Aa is encountered with a >5999 
(iij[) if a global parameter (ki is enco\mtered with a >3999 

(iv) if an attempt is made to set a preset parameter in the range Pi10 - 
P119, unless it is one of the Special Preset Parameters, to set a 
preset parameter Pa v;-ith a >ii9. or to use a preset parameter Pa, 
with a >'129 
(v) if a reference is made tr a library routine number greater than 
1999 

(vi) if a reference is made to a copy number of a library routine 
greater than 1999 

NOT IN LIBRARY 

One of the forms L, La, La.b, E, ER, RLc appears wxthxn a library 
routine. The monitoring occurs as the librajy routine is compiled, 
but this monitor should only affect library routine writers or 
private libraiy routine users. 

EXCESS COMMA , , 

Two or more commas or a comma after Hultiple Space appear bet^veen 
items or parts of an instruction on a line. A comma at the 
beginning of a line will give rise to a V/RONC- FOffi.iAT monitor. 
For the purpose of this fault, comma is not the same as multiple 
space; thus, for example, severed Ti\BS a-e perfectly permissible 
between items. 
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LABEL NOT ALLOWED 

For example, before an E. or a T directive. 

? This occurs v/henever the Supervisor, as opposed to the ABL 

compiler, monitors any aspect of the program. The most common 
cases are: 

Exponent Overflow - (in any arithmetic arising from the form 

of any items) 

Input Not Defined - (after a use of the 'PH5=aexprcssion' 

directive ) 

Output Not Defined - (after the use of the 'Ta' or 'Ta-b' 

directive ) 

Input Unded. 

The normal Supervisor fault printing comes first followed 
by an ABL '?' monitor giving 'where' and the reconstructed line in 
the usual fonn. 

This kind of monitoring can only occur once, because 
of the Supervisor's system of private monitoring. If a second 
error is caught by the Supervisor, only the Supervisor printing 
will p'nTveay and the ^ob will be terniinated- 

If this is the first fault in the program, then the 
line 'ABL MONITORING-' will appear after the Supervisor monitor 
printing but before the '?' monitor printing. 

The monitor Input Jinded may be du« to a variety of 
cause s» The most common of these are: 

(i) Unmatched £, In this case the compiler will scan through 
the whole of the prograia looking for a matching ^ until 
it hits Input Ended, This circumstance can be most easily 
identified "by the Line Count part of 'where' in the accom- 
panying ABL monitoring. The compiler does not recognize 
labels whilst within a |7] sequence, but does count lines 
in the normal manner, so the line count \7ill be from the 
last label before the ^, 

(ii) Un- terminated Enter Directive'. This is trick^^ to spot 

because the reconstructed line looks nonnal. In order to 
avoid tills monitor the *'"'*Z or other dociment terminator 
must not be on the same line as the final Enter directive, 
since ABL inputs and reconstructs the whole record before 
attempting to identify items. 

(iii) Enter Directive omitted completely, 

(iv) Un-terminated private Library Routine (i.e. the 'ZL' record 
omitted or punched incorrectly). In this case the whole of 
the remainder of the program is thought by ABL to be part 
of the Library Routine. 
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<Paranieter > ALREADY SET AT <vThere> 

An attempt is made to set a parameter (Global or Routine) v/hioh has 
already been set. The monitor here consists of one line only; no 
'reconstructed line' is printed* An 'RO' directive will also cause 
this fault. The parameter will retain its original value. 

EXPRESSION INDETEmvIIKATE 

An expression, v/hich has not been rejected for any of the above 
reasons, cannot be fully evaluated v^hen it should be. For example, 
II ix is tile ra-giiT-iiariu sxue ux a, i:t=:cjCpicoSj.'jn ux — ^^^j^j. wu.j->^** 
directive or an Enter dii*ective, then it needs to be evaluated 
immediately, and if it cannot be (for example, because of unset 
parameters), then this monitoring will occur when the item is en- 
countered - in the case of E or ER directives after any required 
Library Routines have been compiled; or, if it is the address part 
of an instruction, or a Half-word or Six-bit word, then if it is 
still not determinate when the next E or ER directive is encountered 
- after any required library routines have been compiled - then this 
monitoring will occur v/hen the Enter Directive is encountered, after 
any monitoring arising from any library routines. Eor the purpose 
of counting errors, all parameters unset at the Enter directive are 
treated as one fault. 

The second line of this monitor printing consists not of the 
complete reconstructed line in which the offending expression 
occurred, but only of the expression itself, and this is not nor- 
mally in its original form but has been partly evaluated, including 
the replacement of all set parameters by their values. 

Because of this system of printing the expression, with known 
parameter values fully substituted, the fact that, for example, the 
parameter A.4/2 appears in the monitor printing indicates that it is 
that parameter which is unset and is causing the expression to be 
indeterminate. 

A reference in an expression to a parameter of a non-existent 
library routine will give rise to EXPRESSION INDSr"JmiINATE monitor 
printing when the next E or ER directive is encoimtered as well 
as a monitor printiag for 'Library Routine NONEXISTENT' (sec Chapter 

--12). - - - - -- 

An attempt to divide by zero in an expression gives rise to 
EXPRESSION INDJT;:M.iINATS monitor printing rather than DWISION 
OVEEELOlf Supervisor monitor printing, for example, if expressions 
such as A5Q0 or A5QA2 where A2=0 are encountered. 

Example : 

A program being compiled attempts to print a title on an 
undefined output stream, causing faiolt printing by both Supervisor 
and compiler. Compiling continues, and. further faults are foiind 
until the eiror density is too great. 
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OmTPUT NOT DEFINED 

INSTR 787975 122,63,24,-1048576 B63 =3-1 048575 B24= 791293 

INSTR 787976 1060,0 ,61 , 16 B61 =r.6 

INSTR 787977 300,0 ,0 , 788005 

B1 =512 B3 =^127 B4 =0,1 B7 =787202 

B8 =787372,4 B9 =257.2 BIO = 2,4 Bl2=-126 

B14=^0.1 B15= 786432 316=917373.4 B17= 917373.4 

B1 8 = 91 7370. 4 B20 = 91 1 . 4 B24 = 791 293 B28 =^1 048576 

B45 = 2.1 B61 =-6 B63 =^1048575 B70 = 787583 

B71 = 917371 B72 =-1 B73 = 132.4 B78 = 128.1 

B79 = 917476.4 B81 = 917372.4 B88 = 917373.4 B90 = 787986 

B&1 = 1 2. 2 B92 = 786740. 2 B93 = 786740. 2 B94 = 1 

B96 =^1044754 B97 =^1305d0«1 B98 = 262656.5 



JiBL MONITORING- 

1,2 AO/O ? 
T10 

1.9 AO/O SHBrn >23 PLACES 
R1U24 

0.10 AO/O • OUT OP RANG-E 
121,2,0,A5680 

4.10 AO/O PilRAMETER OR ROUTINE NO. TOO BIG- 
121,2,0,A5680 

1.11 AO/O EXPRESSION INDETIIRi'LINivTE 
PI 0^17 

4,1 3 AO/O INSTRUCTION? 
121,0,0,0,0 

0,14 AO/O IRREGULM PUI^CTION 
123456yi01Ur 

1,15 AO/O WRONG FOEMAJD 
F,K1, +,44( -1,-1,9, +3; 

3,15 AO/O mONG i'UEldAT 
F,Kl,+,44(-1, -1/3, 43:0 

TOO MANY ERRORS 
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Chapter 12 

FURTHER FACILITIES AND TECHNIQUES 



For most purposes, the irtformation given in the earlier chapters is 

ally, however, it may be possible to increase the efficiency of program 
writing or execution; the follov/ing sections describe how this may be effected. 

12.1 Programmed Drum Transfers 

In the great majority of programs, the user v/ill wish to take advantage 
of the one level store concept and will regaixi the core store and drums as a 
single, large main store. Programs are written as if the entire store were 
core store, and the Supervisor will automatically control the transfer of 
512-word blocks between the drums and the core store as needed, 

Hovrever, circTjmstances can arise in vdiich it is useful to exercise 
some degree of control over these block transfers, both to ensure that blocks 
of infoiroation are already available in the core store Tfhen required, and to 
clear space in the core store by releasing blocks to the drums as soon as 
they are no longer needed; the extracodes provided for these purposes are all 
designed to assist towards greater economy of cime by the avoidance of un- 
necessary Supervisor drum transfers. To understand just how the programmer 
may assist the Supervisor, it is necessary to consider the means provided for 
the regulation of automatic drum transfers. 

In addition to ary store locr.tion explicit in each instruction, there 
is implicit a store reference to the location containing the instruction 
word itself; in either case, the address is taken to specify both a block and 
a word within that block. The block address is invariably interpreted as a 
store request, and the Supervisor will initiate a drum transfer if the block 
is not already in the core store. Normally there will be only one copy of a 
particular block, occupying either a page in the core store or a sector on 
one of the drums. V/ith each 512-word page of the core store there is asso- 
ciated a Page Address Register (P.A.R. ) containing the number of the block 
occupying the page at any particular time; there is also a lock-out digit 
which is set whenever the page is involved in a drum or peripheral transfer 
and so is not available to the main program. At every store request, the 
block address is automatically compared p/ith the content of each P.A.R. j if a 
coincidence is found, the store reference is completed by the extraction of 
the required word from the appropriate page. Otherwise a non-equivalence 
interrupt occurs and the Supervisor drum transfer program is entered; this is 
in two parts, one to carry out the actual block transfers and the other to 
decide which page of information should next be transferred to a drum to make 
space available in the core store. 

Jill requests for information transfers between the core eJid the drum 
stores, v/hether originated by the Supervisor or called for directly by an 
object program, are placed in a drum queue holding up to 64: entries which are 
dealt with in the order of their occurrence. The drur: transfer routine is 
re-entered repeatedly until the queue is cleared. 
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It is arranged that there shall always be at least one free 
page in the core store, so that, whenever the drum transfer routine 
is entered, the first 'read' request in the drum queue can be implemented. 
Then, whilst this transfer is taking place, the drum transfer learning 
program decides vfhich page may next be freed by \7riting its contents 
av/ay to a drum. This decision is made on the basis of the frequency of 
past references to each block of inf onnation, and with the intention of 
choosing the core store page least likely to be referred to. 

The drum learning program only attempts to predict future 
store needs in the light of past requests; it anticipates neither the 
termination of references to a particular block of information nor the 
imminent requirement for a new block. Hence, there arise in the main 
two ways of assisting the Supervisor by means of progranmied drum transfers j 
firstly by releasing core store pages no longer required, and secondly 
by initiating the reading of a new block of information from a drum to 
the core store before it is actually referred to. These are both of 
marked advantage to the system as a whole : the first plainly helps towards 
efficient utilisation of the available facilities, and the second can 
often prove of even greater benefit and economy by reducing the time spent 
in waiting for docvm transfers to be completed - this is especially 
significant in the inner loops of a program. It will be appreciated that 
the time during which a progrcan is held up waiting for a dxim transfer 
is still wasteful, notwithstanding time-sharing, since it may take 
rrom j..o "co z./ mu.j.isecoiius, acpciiu.xiig un one o^xc dov^xv^ oj.^>-, «v. „.,^-„.. 
to another program and a similar length of time to switch back later. 

Ideally, a 'read' transfer should be timed to reach completion 
only just before the first reference is made to the block; otherwise 
the Supemrisor may choose to v/rite the block away to the drum again before 
the program comes to use it. The actual transfer of a block of 512 words 
takes 2 milliseconds, but there is an initial delay of up to 12 
milliseconds, the revolution-time of the drum- 

The core store of Atlas is arranged in 4096 woi^i stacks, with 
16 pages of information sharing each pair of stacks, and each stack 
having its own access equipment; to take advantage of this, and so to 
attain maximum speed, operands and instructions should be arranged, as 
far as is possible, in different pairs of stacks. At Manchester, the 
Supervisor endeavours to read down instructions to pages to 15 and 
operands to the remaining pages of the machine; in the event of a 
non-equivalence interrupt the preference is automatic, being determined 
by the non-availability in the core store of an operand or an instruction 
as the case may be; in the case of a programmed drum transfer, the 
preference must be indicated by affixing a bit 1 before the address 
of a block of instructions, and before the address of a block of 
operands. This preference bit will be the most significant bit of n 
(singly modified) or of ba where appropriate. At the other installations, 
where there is more store, instructions and operands are placed in 
diffei-ent pairs of stacks v/henever possible. Pages 0-15 form one 
stack pair, as do pages 15-31, 32-47, etc. 

Gxtracodes are available for the purposes we have discussed 
and these will now be described with the help of the following notation: 
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Block address, P = P = bits 1 to 11 of n 
Block address, P = bits 1 to 11 of ba 

2 

Number of blocks, K =. bits 21 to 25 of n 

Logical band number, D = bits 1 3 to 20 of n 

Band or page number, d = bits 1 3 to 20 of ba 

Section number, k = bits 21 to 23 of ba 

In all but two of the exfcracodes which follow, whenever, information 
is transferred to a new block, the old block is made free. The exceptions 
are 1162 and 1163, where a block is to be duplicated leaving the original 
copy intact. 

Further, vfhen a block is quoted as the destination of an infonnation 
transfer, either directly or as the result of renaming, any existing block 
of the same name is lost. This vrill apply even if tiie name quoted as that 
of the source is unallocated, and will in fact be the only action taken in 
such a case. Also, in those instructions referring to two block addresses, 
these addresses should not be the same. 

1135 b91 ' = c and c' == n if block number > ba ne?/3y defined. 

Henceforth, each time a block with a number > ba is newly 
defined oy a non-equivalence, store current control in B91 
and jump to n. The block number in ba occupies bits 1 to 
11 and the remaining bits of ba are ignored. The contents 
of 3a are undisturbed. The instruction causing the non- 
equivalence is not executed, n is singlj'- modified. 

1155 ba' = smallest block label > n defined. 

Place in bits 1 to 11 of ba the smallest block number > n 
which is defined for this progr m. The remaining bits of ba 
are left cleared. Only bits 1 to 11 of n are used, n is 
singly modified. If all the program's blocks are < n, then 



iufetue 1 anu the reiutiinin^ bits are oleared. 



1160 Read block P. 

If P is not already in the core store, iiie transfer request 
is inserted in the drum queue exactly as if a non-equivalence 
interrupt had occurred, but control is restored to the objeot 
program immediately the drum queue entry has been made. 
Should -the queue be already full, the object program will be 
halted until the entry can be inseirbed. 

1161 Release block P fiTom the core store. 

This extracode adjusts the parameters used by the drum learning 
program so as to cause it to choose block P next for vvriting 
away to the drum store, if this has not already occui'red. No 
entry is made in the drum queue and the transfer will in 
general take place earlier than if extracode 1165 (below) 
had been used. 

1162 Duplicate block Pi as Pa in the core store. 

/my existing block Pa is always lost, and, if Pi is allooatcd. 
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a oopy of it will be formod as Pa in the oore store. Unless 
the drum store is full, block Pi will finally be located 
there; otherwise Pi will be left in the core store. Pi ^4 Pa* 

1165 Duplicate block Pi as .Po 341 the drum store,. 

Provided Pi is allocated, the effect of this extracode is to 
form a duplicate copy of it. It will be arranged tiiat one 
copy shall always be left in the core store and named Pi ; 
the second copy, named Pa, v;ill be put in the drum store un- 
less this is full, in which case it will be l^ft in the core 
store. Ai^ previously existing block Pa will be lost in all 
cases. Pi :jfcPa» 

1164 Rename block Pi as Pa. 

If Pi is allocated, the appropriate entry in the drum direo- 
tory or the core store P.A.R. is altered to Pa. -Any Pa pre- 
viously existing will be lost. There must be at least one 
more block allo\;ed for in the job description than is defined 
at that moment. Pi ^4: Pa • 

1165 V/rite block P. 

Provided P is allocated and is not already on a drum, it is 
transferred to the next empty sector. Should the drum store 

be full., block P is released, precisely as in 1161. 

" - — f ' •* 

1166 Read block P to absolute page d. 

This extracode makes possible full control of the store by 
those exceptional programs for which this may be worthwhile. 
Before usir^ 1166, the program must set a trap in case page d 
is locked down and reserved by the Supervisor, 
d is in the integer position of ba and defines the absolute 
number of a page in the core store to vrhich block P is to be 
transferred. Before this transfer takes place, pjh^ existing 
contents of d are copied to a free pag^. 

1167 Lose block P. 

If P is allocated, the page or sector occupied 'by it is made 
free. 

1170 Clear new blocks/Do not clear new blocks. 

When a program refers to a main store block for the first 
time, the Supervisor allocates a free page of the oore store; 
floating-point zero will be written in all 612 words if the 
clear blocks switch is set. Initially, this switch is set 
to clear all new blocks, but it may subsequently be set or 
reset by means of extracode 1170 according to the sign bit of 
n:- 

n > Clear new blocks. 

n < Do not clear nev; blocks. 

1171 Change store allocation to n blocks. 

Each program has some number of main store blocks assigned 
to it. This number may be altered during the execution of 
the prograjn by the use of extracode 1171. If there are less 
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than n blocks available in the store, then the program will 
be faulted for ILLEG-AL MJNCTIOIT and EXCESS BLOCKS. 

1172 Set ba' = nijmber of pages available. 

This extraoode provides an estimate of the nimber of core 
store pages available to the program at a particular moment. 
It cannot be assumed that this number of pages will continue 
to be available, since the core store allocations are always 
fluctuating. 

1173 Set ba' = number of blocks available. 

At a particular moment, this extracode records the maximum 
number of main store blocks available, consisting of all un- 
allocated blocks together trith those already allocated to the 
program itself. 

1174 Reserve band D, 

A complete band of the drum store is reserved for the program 
and may subsequently be referred to as band D. 

1175 Read K +1 blocks from band d, starting at sector k. 

d must already be defined by extracode 1174:» The K + 1 
successive sectors k, k +1,..,, k +K are read to store 
blocks P, P +1,..., P +K. If K is 6 (or 7), sectors k 
(or k and k + 1) will be read twice. Thus if K= 6, blocks 
P and P + 6 will both contain sector k. If k is 6 or 7, it 
is taken as or 1 respectively. All blocks involved are 
locked do;^ until the entire transfer is complete. 

1176 livrite K +1 blocks to drum band d starting at sector k. 

d must already be defined by extracode 1174. This extracode 
writes store blocks P, P +1..., P + K to drum sectors k, 
k +1,..., k + K. Sectors 6 and 7 are the same as sectors 
and 1 , If K exceeds 5 some of the earlier blocks are 
overwritten. Thus if K = 6, sector k will finally contain 
block P + K rather t han block P. 

1177 Lose band D. 

The band of thfi dnan store previously reserved as logical 
band D is freed and mesde available far general use* 
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12,2 Optimization of Program IJoops 

The following table gives the approximate times in microseconds 
achieved on Atlas for various instructions. The figures are averages for 
obeying long sequences of each instruction, with the instrtjotions and oper- 
ands in different stacks of the core store. 

Type of Instruction 
am' = am + s 



am' =s am X s 
am' = am/a 
ba' = ba + s 



It is not possible to time a single instruction because, in general, 
this is dependent on 

(a) the exact location of the instruction and operand in the store; 

(b) the instructions preceding and following j for "hcne^rer possible 
one instruction is overlapped in time with some part of three 
other instructions, 

whether the operand address has to be modified, 
for floating-point instructions, the numbers themselves. 



Number of Address 




Modifications 


Time 





i,6 


1 


1.9 


2 


2.4 


0, 1 or 2 


5.9 


0, i or 2 


22.5 





1.7 


1 


2.0 



\l] 



This is illustrated when evaluating a polynomial, using a central 
loop involving a singly modified accimulator addition, an accumulator 
multiplication, and a test, count and jump instruction. The average time 
for this loop is 8,3 jisec, of which the accumulator operations would take 
7.8 ;isec if their individual times are simply added. This leaves only 
0.5 ^sec for the test, count and jump, although the average figure for a 
series of jump instmctions on iiieir own might be ten times as large. 

We shall consider those factors which control the time taken to 
obey instructions, to show what advantage can be taken of them in optimizing 
a program loop which has to be executed mart'" times. 

12.2.1 Store Access 

The main core store consists of pairs of 4096-v7ord stacks. Each 
stack can be regarded as a physically independent store, and sequential 
address positions occur in the two stacks of a pair alternately, the even 
addresses in one stack, the odd in the other. The cycle time of the core 
store is 2 nS,, that is, the time after reading or writing a number before 
another number can be read from or vrritten to the same stack is 2 jjei. 

To reduce the effective access time, instructions are always read 
in pairs and held in two buffer registers called Present Instruction Even 
(PIE) and Present Instruotion Odd (PIO) whilst waitdjig to be obeyed. In- 
structions are executed from PIE, the odd instruction being copied from 
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PIO into PIE as soon as the even instruction has been initiated. 

Because of the 2ys cycle time for each stack the programmer fihould 
separate instructions which refer to operatids in the same stack. 

Per example, the instructions 

i 21 1 

324 A4 

362 A4 

would be executed more quickly if written as 

324 A4 

121 1 

362 A4 
The maximum overlap is obtained when alternate operands come from alternate 
stacks. 

The Supervisor attempts to organise the store so that ins timet ions 
and operands are placed in different pairs of stacks'. On the Manchester 
University Atlas, wherever possible, instructions are kept in pages 0-15 
and operands in pages 16-31'. The programmer can assist the Supervisor to 
do this by using the extracodes described in 12.1. These are of most use 
for jobs vd-th a large amoimt of data. It is then useful to request drum 
transfers in anticipation, and to release from the core store blocks which 
will not be wanted again for some time. 

12.2.2 The overlapping of Instructions 

Instructions on Atlas are overlapped as far as possible. For ex- 
ample, in a sequence of singly-modified accumulator instructions, the 
computer is obeying four instructions for one quarter of the time, two in- 
structions for one fifth of the time, and three instructions for the re- 
mainder of the time. 

This overlapping is possible becr.use the accumulator arithmetic, 
the B-register arithmetic, the function decoding, the B-store, and the 
main core ^tore are independent of each other to a large extent. A number 
of rules which enable the programmer to gain as much advantage as possible 
from the overlapping are given below. It should be noted that these rules 
cannot always be guaranteed to establish the best way of arranging any 
particular loop, as in some cases this can on3^ be done by actually rur^ning 
the program; nevertheless the application of these rules, as far as pos- 
sible, will normally lead to a time reasonably close to the optimum "being 
obtained. 

(a) Instructions vrriting to the main store (usually referred to as 
store-write instructions) should normfilly be in odd-numbered 
locations. • 

(b) In general, B-type instructions can be obeyed whilst accumulator 
operations (other than store-write instructions) are going on. 
Only one accumulator operation can be queued up whilst a pre- 
vious one (e.g. a division) is proceeding. If a third accumu- 
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lator operation is enooimtered, nothing further oan be done 
"until the first one is finished. This third aooumulator oper- 
ation shoTold therefore be delayed xintil all B-instruotions and 
B-tests which can be obeyed before the first aooumulator in- 
struction is completed, have been initiated. 

(o) Pollov/ing a store-write instruction, no further instructions or 
operands can be extracted until the writing operation is com- 
pleted. Many typical program loops, however, include such an 
instruction. It is usuallj'' possible to have tliis instruction 
at the beginning of the loop, and this enables the B-type in- 
struction and return j\mp to be obeyed and overlap any accumu- 
lator arithmetic still going on. As mentioned in (a) above, 
the store-write instruction should preferably be in an odd- 
numbered address. From these tv/o rules, two possible ways of 
arranging a loop, depending on whether it has an odd or an even 
number of instructions, emerge. 

Examples; 

1. Odd nxmiber of instructions 



Even 

Odd 

Even 

Odd 

Even 

Odd 



& 



Store-write 



ir«:onrnn 



1 fi+nr* ■ins+Y»iir>+:T on 



V. 



[Accumulator instruction 
Step B-line 
Return jump 



2. Even number of instructions 



jiven 
Odd 
Even 
Odd 



^ 



Step B-line 
Store-write 
Accumulator instruction 



Return jump 

d) Instructions are extracted from the store in pairs, and, subject 
to the above rules, a loop vd.th an even number of instructions 
should begin at on even addi^ess, so as to minimise the number of 
store references. 

e) Test instiniotions cause more dslay when successful than when 
unsuccessful, and it is usually best to arrange the uncommon 
case (if it can be determined) to be the one which changes ba. 

f ) Jump instructions where the jump will frequently not take place, 
should preferably be placed in an even-numbered address. Note 
that this does not apply to return jumps in loops, as these 
fail to jump only when control leaves the loop. 

g) Sin&ly-modified A-type instructions should always be modified by 
bm, not ba. 

h) A delay occurs if a B-register is operated on in the Ba position 
and then used as a modil'ier in the next instruction. This should 
therefore be avoided if possible d.g. by inserting some other 
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instniction in between. Note, however, that 



124 1 





1 


300 1 


2 




is preferable to 






124 1 





1 


300 2 


1 






(i) G-iven a pair of accumulator instructions, one modified and one 
not, the unmodified one should occur in the even-address, and 
the modified one in the odd-address, if possible. 

(j) G-iven an accumulator operation and a B-register operation as 
an every'odd pair, they should be in this oixier if possible* 

Y/here the above rules conflict, the order in T/hich they are given 
should be taken as the order of importance. 
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i 2, 3 Branching 



Branching is a facility which enables different parts of the same 
program to operate in parallel, using the time-sharing process. Such 
parallel operation is of value if some parts of the program are liable 
to be held up waiting for peripheral transfers tirhilst other parts are still 
able to proceed. It is important to note that simple operation of peripheral 
devices in parallel v.dth computing is available without recourse to bran- 
ching; normally, the program itself is only held up if it attempts to refer 
to the locations involved in a transfer before the transfer has been com- 
pleted. Branching is an additional facility which is intended to permit 
parallel operation of two or more different processes which are liable to 
be held up by peripheral transfers, vrhere each process involves some com- 
putation or organization and does not consist merely of peripheral transfers. 

-12.3.1 Existing Parallel Operations 

u'hen a block transfer to or from a drum or magnetic tape has been 
initiated, by means of a drum or tape block transfer extracode, the program 
is allowed to proceed as long as it does not refer to the main store block 
involved in the transfer. If it does refer to that block, it is held up 
until the transfer has been completed. 

Variable length tape transfers operate by using part of the main store 
as a buffer. It is usually possible to keep suffioient information in the 
buffer to pennit the actual transfer, between the buffer and the specified 
store address, to take place as soon as the trp.nsfer instruction is encoun- 
tered. OtheiTwise the program will be held up until the transfer is complete. 

Other peripheral devices, apart from the drums and magnetic tapes, 
are not normally controlled directly by the program. Instead, the input 
documents are read and stored on a system magnetic tape before the prograia 
is initiated, and output documents are stored on a system tape and printed 
after the program has been completed. 

12.3.2 The Branch Instructions 

ii03 Permit Ba Branches (2 < Ba < 32) 

Before any branching can take place, the program must obey an 1103 
instruction, which enables the Supervisor to prepare for brandling. 

This instruction normally takes the form 
1103 Ba pDi 

After obeying it, the program is peiroitted to have up to Ba live 
branches, including the main program, in progress at any one time; the main 
program is defined as branch 0. Vihen the Supervisor switches from one 
branch to another it will preserve certain standard information and also 

the contents of index registers Bp, B(p +1), B(p + 2),.. ...., B99. 

Note that if the N-address is zero all index registers are preserved, and 
if p = 91 only the extracode index-registers ars preserved (these are 
usually essential). 
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ii04 Start Branch Ba at n (0 < Ba < 63) 

The current branch of the pro gram continues at the next 
instruction, but a new branch, with number and priority Ba, 
is started at address n. The highest priority is ^ven to 
the highest-numbered branch: if other branches with the same 
number Ba have been defined previously, they will take higher 
priority than the new branch. The main program is initially 
defined as branch number 0# 

ii05 Kill Branch Ba or Ciirrent Branch 

Kill all branches with the number Ba. If Ba = 64, kill the 
current branch. This prevents any further instructions being 
obeyed in the specified branches, but peripheral transfers al- 
ready requested will be completed, 

i106 Wait xmtil Branch Ba is Dead. 

Halt the current branch of the program if any branch numbered 
Ba is still live. Proceed to the next instruction when all 
branches numbered Ba are dead. 

ii07 Jump if Branch Ba Live. 

Transfer control to address n if any branch numbered Ba is 
still live. Otherwise prooeed to the next instruction. 

12.5.5 The Use of Branching 

A branch is usually started at some point in a program vfhere it is 
required to carry out two different processes, at least one of which is 
liable to be held up by peripheral transfers. Usually, the more severely 
peripheral limited process is put in the new branch, and this is given 
higher priority. V^en the program is obeyed, the higher priority bra^ich 
is allowed to proceed until it is held up waiting for a peripheral transfer; 
control is then transferred to the other branch, Yfhich proceeds either until 
it is held UP, or until the higher priority branch is ready to resume. 
Similarly, if' there are several branches, the Supervisor ensures xnax con- 
trol always passes to the highest-priority branch able to proceed. Each 
time control is switched from one branch to another, the Supervisor stores 
and restores the contents of the following registers and indicators: 

The Accumulator 

B1i9, Bi2i, B124, Bi26 and B127. 

The Index Registers specified in the 1103 instruction. 

The Selected l.iagnetio Tape Number. 

B-Test, B-Carry, Accumulator Overflow (V-store Line 6). 

Extracode Working- Space, 
Thus, each branch crn use these registers as though it were one single pro- 
gram uninterrupted by other branches. It is, however, necessary to ensure 
that two branches which may operate sioultaneously do not use the same 
main store locations, or index registers which are not preserved. It should 
be noted that the selected Input and Output are not preserved, and therefore 
input and output can each take place in only one branch at a time. 
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Once a branch has been started it oan be regarded as a 'live' branch, 
and it remains live, even when it is held up, until its task has been com- 
pleted, V/hen a branch has completed its task, it must die, and this it 
does by obeying an 1105 instruction, usually with Ba =3 64» 

When one branch of a program is ready to malce use of the ^irork done 
by another, it must first ensure that the work has been completed. This 
may be done by obeying an 1106 instruction, which causes the current branch 
of the progrpjn to be held up until the specified branch is dead, having 
completed its task. 

A simple example of the need for brajiching arises when it is required 
to scan a magnetic tape in order to process a selected sample of the in- 
formation on it. The processing routine and the tape-scanning routine can 
then be written as two separate brrjiches, with the tape-scanning ixDutine as 
the higher-priority branch. 

Example : 

'It is required to scan sections 1 to 3000 of tape 4 and to 
apply a lengthy processing routine 113 to the information in about 
25^ of these sections. The sections to be processed are to be 
identified by having a number greater than 0.32 in the first word 
of the section. The program to do this could be ;7ritten as follows: 

Branch 

1103 2 89D1 Prepare to use 2 branches, 

preserving b89 - b99. 

Search for section 1 , tape 4 

Set count for 5000 sections 

Clear mai^ker in B16 

Start branch 1 at A6 

5) 1106 1 Wait until branch 1 dead 

Exit if last section processed 

Rename block 3 as block 4 

Start branch 1 at A7 
Set Link for return 
Enter R3 to process block 4 
Branch 1 

6) 1002 4- 3: Next section to block 3 

First number in section 
Subtract 0,32 
I]xit if number > 0,32 

7) 203 127 89 A6 Count tape sections 

Mark b16 non-zero 

(Program continues on following page) 
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1001 


4 





1 


121 


89 





2999 


121 


16 








1104 


1 





A6 


1106 


1 








215 


127 


16 


A12 


121 


10 





4::) 


1164 


10 





3: ) 


1104 


1 





A7 


121 


90 





A5 


121 


127 


^ 


AI/3 


1002 


4. 





3: 


324 








3: 


321 








1A8 


236 


127 





A8 


203 


127 


89 


A6 


121 


16 





7 



12.3/4 

8) 1105 64 Kill current branch 

^0,32 



1) 



R5 R3 (Part of Branch 0) 

• • • • ^ 

) Routine to process the 

* * ) information in block 4 



The chart belov/ shows how control ifould pass from one branch 
to the other in a typical sequence of operations v/hen the program 
is obeyed. InteiTruptions from the Siipervisor and higher-priority 
programs have been excluded because they vrould complicate the chart 
without altering the sequence significantly. The sequence of oper- 
ations starts at the top with the beginning of the program, runs 
through the first entry to branch 1, and then cycles ro\md a loop 
in which branches and 1 operate in parallel. The chart shoves 
branch completing its work before "branch 1 has found the next 
section to be processed, but branch 1 night equally well be finished 
first, that is, a further required section may be found during pro- 
cessing. It should be remembered that each entry to branch 1 takes 
orJ.y a few microseconds, v/hereas 64 milliseconds must elapse between 
successive entries to branch 1 to read one more tape section. 



See Chart on follovTing page. 
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LOWER 

PRIORITY 

PROGRAM 



PROCESSING PRO&RAI^ 
BEMCH BRMCH i 



Enter Program 
Start Branch i 



> 



Other Computing 



^ 



Wait for Branch 1 



if 



Initiate Tape 
Transfer 



^ 



/f^ 



^ 



5J Section not 

required. Initiate 
Tape Transfer 



i 



Other Computing "^ 



^ 



Start Branch i 



f 



Required section 
found. Kill 
current branch 




|T< 



-p I 

o . 

(E I 
CO 



Process t)3.ock 4 



Initiate Tape 
Transfer 



■^ 



^ I L 






Continue Processing 



^ 



Section not 
required. Initiate 
Tape Transfer 



■7' 



Z. 



Other Computing 



End processing 
block 4. Vfeit 
for Branch i 



if 



Section not 

re quired. Initiate 

Tape Transfer 



mseoi 



64" msec, i See 
-* / Note 

B 



64 msec. 



Notes : 



A. This loop will be repeated until a required section is found, 

B. If a required section is found, then Branch "I will be killed. 
\^en the current block has been processed, Branch will 
start Branch 1 again, and then process the required section* 
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12,5#4 Store Requirements 

VThen an 1 "103 instruction is obeyed, the Supervisor assigns sufficient 
storage space for the specified number of branches. This storage space is 
taken out of the main store allocated to the program, either by the job des- 
cription or by a subsequent use of the extracode 1171, and will be counted 
in the estimates made by extracodes 1172 and 1173; it is therefore necessary 
for the programmer to know how much store is required by the Supervisor for 
branohin/' purposess Many cases should be covered by the following table, 
showing the maximum number of branches that can be accommodated in 1 , 2 or 
3 blocks, depending on the number of index registers preserved. 



Index 
Registers 
Preserved 


Storage Space Allocated 


1 Block 


2 Blocks 


3 Blocks 


Maximum Number of Branches Permitted 


BO to 99 


3 


10 


18 


B30 to 99 


4 


14 


24 


B50 to 99 


5 


17 


29 


B70 to 99 


6 


22 


32 


B80 to 99 


8 


27 


32 


B90 to 99 


10 


32 


" 



If it is necessary to estimate the store required in some case not 
covered by the above table, it is probably easiest to do this by considering 
the way in which the Supervisor allocates this store. It takes 300 words 
at the beginning of the first block to store branching routines, and follows 
these b'^'' 6 words for each branch requested in the 1103 instiniction. Each 
branch is then allocated a further (11 + ■^) v/ords, v;here m is the number 
of index registers in the range to 99 that are to be preserved. The 
(11 + ^) vrords for one branch must all be in the same block, and if less 
than (11 + -gm) words are left at the end of a block the (11 + -gm) words 
for the next branch i^rill start st the beginning of a new block. 
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i2,4 InstJTUotion Counters 

As each iDasio instruction is dbejed, an instruction counter is 
stepped on, normally by one, "but by two for miatiplication orders, and by 
four for division. Each tine the counter reaches 2048, an interrupt occurs, 
and an instruction interrupt counter is stepped on by one. This latter 
counter is used by the Supervisor in monitoring the program, but may also be 
read by the program using extracode 1136, 

i-136 Read instruction count. 

Set am' to the number of instructions obeyed from the start of 
the program; this will be a fixed-point integer \7ith exponent 
i6, and will be a multiple of 2048, 

Besides "this count, the progrsoa may also use a local instruction 
counter. A trappable fault wlLl be recognized when this count expires, which 
may provide a convenient way to end an iterative loop, since th^ counter may 
be set as well as read by program. 

1123 Set local timer. / r^y^o 

Set the local instniotion coxmter to local timer = 2048n 
n X 2048 instructions. The Supervisor 
v/ill override any attempt to set the 
counter to a figure in excess Ox muC 
amount of allotted time remaining. 

1122 ReexL local timer. ^ 

Read local instruction counter into ba = local timer 
Ba in units of 2048 instructions. 



( 1.65 ) 



i2.5/1 



12,5 Re-entering the Compiler 



Most programs are compilecL completely before they ai^ entered, and 
therefore it i& not normally necessary to retain the compiler in store during 
the program's execution. The E-type of directive is the only enter directive 
which deletes the compiler from the store before transferring control to the 
object program, and so is the most commonly used. 

In some circumstances, however, it is necessary to enter the program, 
and then compile more program later. The first entry may be to actually 
execute part of the object program, or it may be O'nly to set certain para- 
meters. The compiler must be retained in store for these purposes, and so 
either an SR or EX type of enter directive must be used. The compiler uses 
store locations J3 (3/4 x 2^° ) and above vrhich should not noircally be altered 
by the program, although no check is made except when actually compiling. 

The EX-directive is intended for obeying 'interludes' during compiling; 
an interliide would normally consist of a few instructions only, or of none 
at all. For example, if it were required to have any ABL fault printing on 
some output stream other than Output 0, then a one instruction interlude to 
'select output' would suffice. If it is only required to set parameters, 
then the address specified in the EX-directive should cause immediate re- 
entry to the compiler J such a directive in fact occurs near the beginning 
of L-ioO, the general input routine, to detenaino the various optional 
parameter settings. The EX-directive does not call down any library rou- 
tines; if these are required in the interlude, they must be called by one of 
the L-directives before obeying the EX entry. No distinction is made by the 
Supervisor betvfeen compiling proper and obeying an interlude, i.e. the 
'Compile/Execute' switch is not changed. 

The ER-directive is designed to allow part of a program to be compiled 
and executed before reading more program, and provides most of the facilities 
of an S-directive, including the compilation of any library routines men- 
tioned but not called earlier in the program. The routine current when the 
ER-direotive is obeyed will h&- tenninated before more program is reav*. y^-.*-e 
EX-directive does not do this.) The Supervisor recognises that an object^ 
program is being executed, and as with the E-type of directive, the 'Compile/ 
Execute' switch is set to 'Execute'. 

Two types of list within the compiler are used in cohnectidHirlth 
parameters in a program. The parameter lists contain all those parameters 
which are determinate, and if the program refers to a set parameter, these 
lists are used to replace the parameter by its value. If a program refers 
to a routine or global parameter before it has been set, then this is noted 
on a forward reference list, from which it is deleted vfhen the parameter is 
detenninate, and hence, so long as this list is not empty, there are some 
parameters still to be set. When the compiler is retained in store, these 
lists also remain, in the same state as when the enter directive was obeyed. 
If more program is to be read wliich uses parameters to 2?efer back to the 
program compiled pre*7iously, then it is essential that the lists remain 
\maltered. If, however, the subsequent sections of program are to be 
compiled independently of the earlier part, or if the same parameters are to 
be used again with different values, then the lists must be cleared on re- 
entry to the compiler. Different re-entry points provide for both require- 
ments, and are listed below. In every case, re-entry to the oompiler does 
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not alter the 'Compile/Execute' switch. After compiling program, 3i-B88 
will be cleared, and B89 will contain the final transfer address. The other 
B-lines may be destroyed. 

F^20 When the compiler is re-entered at address Pi 20, all parar- 
meters,' forward references after EX, and * (the transfer 
address) are left unchanged, and more program is read f2?ora 
the current input stream. If there is no *-direotive 
before the first items are read, these will be placed In 
store sequentially in the usual way, after tlie last item 
of progrsm before the previous enter directive. After an 
M-directive, library routines may have been compiled into 
locations beyond the end of the written program. 

Pi 20B Re-entry at this address causes the compiler to behave as 
it does when first called by the Supervisor, but the con- 
tents of the store below J3 are left imdisturbed. Hence 
* = 1:0, and the forward reference list and parajneter lists 
are cle tired. 

The compiler may also be used as a subroutine by a program, control 
returning to the main program vvhen no more items are to be read. Again 
there are t\¥0 modes of entry, depending on what is required of the com- 
piler lists. 

If the transfer address is written to location Y4Pi2'1, and the link 
to i29E^2i, then re-entry to the compiler at Pi 20 will read more program, 
retaining the compiler lists. Return to the linlc address in the main pro- 
gram is effected by 

IIPi29 
SRPi29 
or E]JP129 

If the transfer address is written to BSD, and the link to B90, 
when the compiler is re-entered at PI 20BY6, more program will be rer.d as if 
the re-entry were to P1 20B, except that an attempt to compile into store at 
an address less than b89 will be faulted, and that the transfer address will 
be taken as * = b89 unless b89 = 0, when * = 1:0. Return to the main pro- 
gram is again by LjIFi29 etc. 

PI 20, PI 21, and Pi 29 are examples of special preset parameters, which 
are described in the next section. 
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12,6 Special Preset Parameters 

Although for noiraal pu27poses only Preset Parameters to 99 may be 
used^ some above iOO do exist and these r.re used in special ways for special 
purposes- In some cases use of them causes special action by the compiler j 
in other cases they are used to convey information between the compiler and 
the program, 

PI 00 to PI 09 are in many w?ys liiJkie ordinary Preset Parameters; they 

wan uc reSci/ uj out; piOgrcUUiiiex" culu. ii\j d^cuj-cuL ch^uj-wxi j-o o eus-on uj uLic: v>v-ilu"' 

piler on encountering them. However, they are initially set by the compiler 
at the start of compilation and they are referred to by the compiler during 
the course of compilation. 

PiiO to Pi 19, if defined, may "be reset by the programmer but will 
have initial values set for them by the compiler. Howerer, whenever an 
Equation Directive for resetting them is encountered, special action is re- 
quired by the compiler. An attempt to set one of these parameters not 
listed below is faulted. 

Pi 20 to Pi 29 are preset by the compiler, but may not be reset by 
program. An attempt to do so is faulted. They are used to convey infor- 
mation from the compiler to the program. 

PI 00 " Optional Printing 

At the start of compiling ABL sets Pi 00 to zero. Non-zei*o settings 
of Pi 00 cause ABL to print various kinds of information during compiling. 

Pi 00 is treated by ABL as made up of 8 octal digits abodefgh. Each 
octal digit controls the printing of one kind of information, as indicated. 

If the least significant bit of an octal digit is 1 the iiifonnation 
controlled ^oj this digit will be printed - on a new line if the middle bit 
of the di'^it is 1 and on the sans 1 iyy ; if the middle bit is Cs if the least 
significant bit is 0, then the other tvTO bits are ignored. If the most 
significant bit of the second digit (b ) is 1 , then printing on a new line 
will occur when a library routine is compiled. Otherwise the most signifi- 
cant bits of the digits are ignored. 

Pi 00 is preserved ani set to zero before compilation of each library 
routine and restored afteiwaid-s, so that there will be no other optional 
printing, unless the library routine contains a 'PlOO =' directive. 

The kind of printing controlled by each octal digit is as follovfs. 
All printing is preceded by a space, except R. L is printed on a nev/ line. 
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Octal 
digit 


ABL prints 
this 


when it meets this 


a 


•=P 


* = expression 


b 


La.b N * j= q. 


Ra 

Library routine named N compiled 





S» = ci 


Z 


d 


this digit is unas 


signed and ignored 


e 


P 


P i11 = expression (see Flii) 


f 


S p 


E expression 


g 


E R p 


M expression 


h 


E X p 


EX expression 

_...._ 



v^here p is the value of the expression met, 
^ is the current value of asterisk 
a and fc are integers. 

Some examples of useful settings of Pi 00 are 

PI 00 = -yi ABL prints on R, L, * , Z and all types of E, 
each item on a new line 

Pi 00 = J03 ABL prints on II only 

Pi 00 = J03i JSL prints on R and Z 

PiOi <- Permitted Number of Errors 

At the start of compiling ii3L sets PiOi to 0,2. This is equivalent 
to infinity since for each error met iiBL reduces Pi 01 by i , and when it 
reaches zero stops compilir^ and ends the run after printing 

TOO liANT ERRORS 

The program may set PiOi = n where n is any expression. Compiling will 
stop when n + i errors have been met. PiOi = causes ABL to stop on the 
first error met, which may be useful for a developed program. 

No matter hovf many labels remain unset when the E directive is met 
ABL limps them all together as one error for the purpose of counting errors. 

Pi 02 - Entry Despite Faults 

At the start of compiling ABL sets Pi 02 = 0.2. If any errors have 
been found, an EX directive will be obeyed, but an E or ER will not, and 
.^L vnj.1 print 

ERRORS DO NOT ENTER 
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and end the run. 

Pi 02 = allows all 3 E directives to be obeyed despite errors 
Pi02 = 0.3 forbids aU 5 i^i directives after errors 
Pi 02 = 0.1 allows S and ER but forbids EX after errors 
Pi 04 - Setting Private Monitor 

PI 04 is the address of a Drivate mom'-hrir» ynn-h-in^i T.r>,i-^K a r, „^j. 

eacn time any Lnter Directive is encountered. Thus if 'any monitors occ^ 
after the Enter Directive (including an immediate entry to an address holding 
an Illegal Function due to a wrong Enter Directive address), these will give 
J^!o / ^ ^''^''^^ "^^ Private Monitor according to the rules of extracode 
•1-112 (see section 11.3). If P104 is negative any current setting is ter- 
minated. ° 

PI 10 - Change of Program Location 

At the start of compiling, ABL sets P110 = 0. A non-zero setting of 
PIIO^ specifies the difference between '"' as evaluated in expressions (say * ) 
and ' indicating where items are to be stored (say * ) '' 

i.e. P110 = * - '' 
1 2 

Setting PIIC^ permits the compiling of program into one set of store 
addresses - -g - for later execution in another set of store addresses - *. 
(e.g. after 'Renaming' or after storing on nagnetic tape). Thus, for ex- 
ample, _ a program which is to be executed starting at address J3 but com- 
piled initially into store starting at J1 would have the directives 

P110 = J2 
= JS at its start 
P1 11 - Expression printing 

YvTien ABL meets the equation 

P111 = e3q)ression 
it eraluates the expression and sets P1 11 in the usual way. If the 
appropriate bit of PI 00 is set, the value of the expression 'is'llilttSdlS^dXv 
printed out. 

P112 - Unused 

This parameter is used by ABL on Atlas 2. ^ No fault will occur if 
the program sets P112, the value being assigned in the usual way, but the 
remainder of the line on which the setting occurs will be ignored. The 
compiler initially sets P112 to J3. P112 should not normally be used 
with ABL on Atlas 1 , 

Pi 15 - Change of Input Stream 

The equation P115 = n(n is any expression) causes ABL to start 
reading program from the programmer's input stream n. The rest of the 
line on which P1 15 occurs will be ignored. 
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PI 20 - Ro-ontTj^ to tho Coapller 

This is described in the previous section, 

PI 21 - Preset Parameter List 

PI 21 is the address of the start of the compiler's Preset Parameter 
list, Halfvford Pl21+n contains the value of parameter n if it has been 
set. This list can of course only be referred to by a program entered by 
an ER or an SX directive. This is a list of alternate half\vords, the other 
half words of v/hich are used for other purposes by the compiler and should 
not be disturbed. 

P122 - State of Preset Parameters 

P122 is the address of the start of the compiler's list y/hich in- 
dicates whether the Preset Parameters are set or not. Bit 1 of halfv/ord 
Pl22+n is a 1 IT parameter n is unset, if set. This is a list of al- 
ternate halfv7ords, and neither the other bits of the halfv7ords, nor the 
other halfwords should be disturbed if subsequent use of the compiler is 
intended. 

Example ; An 'interlude' to set P17 = if P36 = and to 
leave Pi? unaltered otherwise 

5) 121 1 P35 

215 127 1 PI 20 

113 P1214-17 

121 1 J2' 

117 1 P122+17 

121 127 Pi 20 

EXA5 

P125 - Characters Count with G directive s 

Pi 2 3 indicates the number of characters read by means of the pre- 
vious C directive, descidbed in section 6.10. 

P129 - Return from Compiler 

PI 29 is the return address when the ABL compiler is used as a 
subroutine (see previous section). 
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"^2*7 Private Library Routines 
12,7.1 Librai^r Routine Titles 

Library- routines are given numbers and names; the program refers to 

them by nmiber, but the name may be useful to indicate their piirpose. The 

standard input and output routines, described in Chapter 8, have been given 
names as follows: 

LI G-EKilL\L OmjpWf 

LI 00 G-ENERAL INPUT 

L1 99 LINE R";C ONSTRUCT ION 

LI 99 is used by LI 00, and hence, if the library routine is being com- 
piled implicitly, (whether by an 'L' directive or by an Ilnter directive), 
LI 99 v;ill^ automatically be compiled \7ith LI 00 because the latter refers to 
it, but, if it is required to compile the 'input library' explicitly into a 
part of the programmer's store area, then it is necessary to use both of 
the directives 

L100 

L19S 

12.7.2 Undefined LibraJ?;^^ Routines 

^All undefined library routines have the name NOFEXISTMT and there is 
a special device to make the optional printing as described for PI 00 
(section 12.6) compulsory for non-existent routines. 7or example, output 
such as 

L10 NOI^XISTSI'S *= 2:56.3 

will result from either an attempt to call for LIO explicitly or when an 
attempt is macLe to compile it by an L or IZnter Directive when it has been 
referred to implicitly. The latter would also result in monitor printing 
about unset labels. 

/my defining of a Private libraiy routine (see below) vTill cause 
suspension of the ?S:']MCXIST3?]T monitoring for that routine. 

12.7.3 Preparing a Private Librarj' Routine 

Private Libra2r>*- Routines may be incorporated in the normal program 
input stream and may be referred to in the progr m in the same vfay as public 
library routines. 

ilie routine is headed hy tivo lines: 

RLc 

< Name > 

vfhere c is the number assigned to the librarj^ routine and < Name > is the 
name of the routine. If no name is required, this line must be left blank, 
and then a blank title will appear in any optional printing. The Name must 
not consist of the tv/o-character reoorcj ZL» 

The routine is terminated by the two-chf^racter record ZL, This is 
not line-reconstructed and may not contain any spaces, erases, backspaces, 
i^aos etc. 
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The libraiy routine may consist of a sin^-le routine (routine 0) or of 
one or more routines headed by routine direoti-vxis and optionally tenDiii.ated 
by Z directives in the usual way. It may contain any of the normal ABL 
forms except the directives 

L, La, La.b, ER expression, E expression, RLo 

All will be monitored. No T or C directive vfithin the library routine may 
be followed by the two character record ZL. 

V'vhen the RL directive is encountered, the library routine follovdng is 
simply copied character by character into the compiler's store area. The 
routine is not, at that time, compiled or placed in the prograiiimer ' s store 
area. This is achieved in the normal way, by an E, ER or 'L' - type of di- 
rective. 

If a private library routine is given the same number as a public 
library routine, it replaces the public one for the remainder of that pro- 
gram. This is convenient for the development of nevr versions of existing 
public routines. 

Private Library Routines must precede any calls for them in the body 
of the program. The best place for them is at the beginning of the program 
stream. 

A private library of routines required by people working in some 
limited field (e.g.. properties of steam) may be formed by putting the rou- 
tines on to a titled paper tape (as pseudo-data) and terminating them by 
Pi i 5=0. The master programmer may then write, for example, 

INPUT 

15 STSiJ^i LIBRAEJ 

in his Job Description, and 

P115=:15 

at the head of his progrpjn to incorporate these routines effectively as 
above. 

Each private library routine incorporated in the way described in 
this section counts as one line from the point of view of line counting for 
error monitoring of the subsequent program. 

The directive 

P115 = expression 

within a library routine, will not cause monitoring, although it should 
never normally be needed or used. Its effect is in fact to cause switching 
of the input stream after completing the compilation of the current library 
routine or routines at the point where these are compiled (i.e. at an L or 
Enter directive). 
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''^•'^•"^ Incorporatin g a new Library Routine into the Publjo Library 

the svi^' ^?i°?!.??/^^f '^ a special job, using a standard program of 
tne system. Jsssent3.ally, the routine to be incoi^orated is put at the head 

bv ^h Pj:^^''!'^''^^ ^^ ^^" ^"^^ ^^^' ^^ described above/and is folWd 
by ohe standard program. This program uses no labels as the non-empty p^a- 
meter list would otherwise become part of the compiler. 

If the routine being incorporated is a new -version nf ar al^^ad- --= 

;??i;V''"^'"''^ ^^^S ^^ ^^^^^"^ ^^ "°* destroyed or overv,-ritten onVe com- 
piler tape. The reference to it in the compiler's library routine list is 
simply changed and so it becomes 'dead^ A separate special proSam for 
mL^''i'S '^' ^''I' ^^"°^^) ^^^ ^^ ^^^^ fx^m time to'^ti^.e to c£S iut all 
^ttt tM^T ^?^^^^^!' ^^^ ^^i^ ^1^^^ o^t all live ones as well, so that 
after this clearing out operation all public library routines must be re- 
incorporat;ecL» 

■^2,7.5 Conventions 

The following conventions are recoiranended for library routine writers 

(i) Communication of parajneters ojid addresses for use at compile 
time should be by routine paraiieters of routine of the 1-ibrarv 
routine, since ~ *^ 

(a) using routine, global or preset parameters of the master 
program could easily lead tc clashes with other library 
routines if allowed, and 

(b) the master programmer will not be interested in +he 
breal^do^ra of the library routine into sub-routines. " 

^HLV^ Preset parameters are used within the library routine, they 
should be high numbered ones, say PSO-99, and should be unset at 
the end of ^ the ^library routine. Their use should be mentioned in 
..xxe speciiioaoxon for the library routine. 

(iii).'Lny special preset parameters used (except Pi 00 and Pi 23) should 
be presei-ved and restored. ^ 

^2.7,6 Referring to the master program from within a librar y Mutihe 

. i.-Kv, ^ ^o^-tf^e parameter of the master program can be referred to within 
a library roucine by treating the master program as if it were library rou- 
tine C, e.g. A6/3L0 is A6/3 of the master progrejn. 
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'J 2- 8 Correotion of Programs, and System PeoUliarities 
i2.8#1 Program Alterations 

To corroot a small program, it is usually simplest to ru-punch the 
tape or cards, making alterations as necessary. This is impracticable for 
larger programs,but the facilities of iUBL may be used to help make cor- 
rections. 

Very often it is possible to make corrections by overwriting certain 
store locations, using a ""-directive. The corrections, hov,rever, must be 
compiled after the faulty items, or uie faults vdll overwrite the alter- 
ations. Hence, the corrections are normally placed just before the enter 
directive. An enter directive may cause library routines to be compiled 
from the current transfer address, and so to prevent the program being 
over^TTritten from the faulty item onv/ards it is necessary to insert the cor- 
rection in one of the following ways. 

a) i ) <Ijast item of program proper> 

*=6AlO/4 
<Correction> 

* = iAi 

EA40 

b) <Last item of program proper> 
L 

* = 6A10/4 
<Correction> 

1) jilA40. 

In case b), however, if data is read to Ai oiiBrards^ this will also 
over?;rite program when the correction is inserted. 

It may be convenient to end a program with 
R-IO 
1 ) <Iiast item of program proper > 
Pi15 = 15 

* == U1/10 

EA40/5 

so that corrections, if any, v/ill be read from input stiream i6, which ends 
with P115 == 0. 

When routine parameters are mentioned in a correotion, without 
specif jring any routine, i.e. /n is omitted, the routine to which they refer 
will be that current before the correction, rather than that at the location 
to be corrected. 

Difficulties may be encountered when using '*=' to overwrite an 
item containing forward references. The result can be predicted from the 
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following notes on ABV s handling of forward references. 

,,^T,, Two lists are concerned, the forward reference list in which are 
m^;;^?:T ^^'''^^?'^^''%°''' ^^^^^^^^S ^<^^^ard references, and the para- 
vSues S set. '"''" parameters fourd in the progr.:^ with theL 

(i) The fon?ard reference list is initially empty. 



/^A \ 



— -- V— >.xj^*^^su.wxi a.o xcau. xu J.B adaea to tne end oi' the for- 
ward reference list, which is then condensed starting from 
that expression. In the case of indeterminate parameters which 
need to be evaluated before compiling continues, i.e. after EX, 
_., =, Pa=, and Pa?= when Pa has not been set earlier (a is an 
integer), then the e^rpression will, be faulted as EXPEESSION JN- 
DETEiy.iBIATE (see section i1,6). 

(iii) Whenever a routine or global parameter is set the forward re- 
fernsnce list is condensed from the beginning. 

(iv) On reading an S or M directive all necessEJTjr librorv routines 
are read, any outstanding 'a^' or '&-£=' directives are im- 
plemented in the order in ^vhich they occur in the program 
(this may lead to further settings of parameters and so further 
condensations of the forward reference list), and if* the for- 
ward reference list is not empty its contents are output as 
Indeterminate Expression errors. 

(v) On reading EX, A?t= or &?= are iaplemented as in (iv). 
Condensation of the forward reference list© 

1. For each expression in turn, each set routine or global parameter in it 
IS replaced oy its value and the exr;ression is partly evaluated. If no 
parameters remain unset the e:q)ression is completely evaluated; in that 
case,^if the e^raression is not the right-hand side of an 'A?=:' or '&?=' 
^x.<=^oxv«, ii: IS Planted in the pix)gram area or the Darameter list and 
deiexed from -che forward reference list. 

If, on reaching the end of the fonfrard reference list, any parameters 
have been sei; during 1, the process is repeated from the be^Muiing.. 
For example, suppose the program begins 

*=0, HAS 

A3=^4-1 

*=0, HA3-1 

A4=:4 

On reaching the 4th line the forv/ard reference list will contain the 
expressions A5, A4--| , A3-1 . \Vhen the 4th line is read the list becomes 
A3, A4-'1, A5-1, 4; 

the '4' is evaluated inmiediately and A4 becomes set: the list is then 
completely re-condensed. 

A5 is not yet set and so remains'. 
A4-i is evaluated and A3 gets set. 
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A3-i is evaluated aiid planted. 

The list now consists of only A3 and since a pai^ameter was set in the 
last condensation the list is re-oondensed* 

A3 gets evaluated and planted. 

It is seen that in tliis case the half -word ends with the value of A3^ 
i»e. 3. 

If a routine or global parameter is optionally set more than once, 
but is not set otherwise, then the first optional setting v/ill be imple- 
mented. The subsequent optional settings will not be checked for faults. 

A different mode of correction uses the library facilities of the 
ABL compiler. A copy of the compiler would be dumped initially onto a pri- 
vate magnetic tape, and subsequently used to compile routines as a library 
on to the tape. As these routines are corrected, the new versions are in- 
troduced, replacing the faulty library routines as described in section 
12.7.4. 

12.8.2 Further Peculiarities 

Floating-point numbers may be represented in the form a(b:o):d or 
Ka(b:c):d as described in section 5.11, Although the number may be within 
the range Ox one acoumu-Lator, compZLxing lu may cause exponenu ovei.j.-i.ow un- 
less the fo3J.owing three limitations are observed. 

(i) |b4c| < 100 

(ii) |b| < 1000 

(iii) a consists of not more than 20 digits 

\Vhen a parameter optionally set by a "h^ directive is actually set 
elsewhere, the right hand side of the equ£ition for the optional settings 
Day net. be checked. 

After the final ABL fault printing, no new line is output. 

ABL will read program incorrectly after 8191 =2 ^^ - 1 printed lines 
without the implicit setting* of a routine parameter by labelling. 

In fault pointing, the line count will be taken modulo ^^. 

Ko check is made that function codes exist. One and two digit 
functions are right justified into the function bits. 

Yi/hen obeying program, the compiled value of * will be different from 
the current value of control, as b1 27 is stepped on by 1 before starting 
to obey an instruction. Thus 

121 69 127 -* 

would set ^69' = 1. For the same reason 

121 127 127 -i 
causes a loop stop. 



( 1.65 ) 



12.8/4 

When more than twelve digits in a number are printed by the general 
output routine L1, digits after the twelfth may be wi^. 1^1 LsfmS S^ 
exponent overflow attempting to print the f ol!^wd^^;rs:- ^ ^ 

Nonr-zero Mantissa Exponent 

-■^ +127 

+ x(x^-1) -127 

±2: -128 
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"is. 9 Compiler and Supervisor Extraoodes 

TV,.,, '^^i extraoodes given below are used mamly ty system programmers. 
They complete the list of Atlas i extraoodes. t^«u-ucx-». 

1126 v7' = n 

and hoot if the least significant integer bit of n is 1. (bit 20) 

1127 ba' = v7 & n 

t^bits^6^23*of°Ba*^^ engineer's handswitches with n, and read them 

T.n^-. HA^of ^ °v ^^"^ <><^ntral computer V-store consists of &-bits. OnLv 
bits 16-23 may be read, being set from the engineer's handswitches. Other 
bits are read as zero. Bit 20 controls the hooter and may be set by pro- 
gram; writing to the other bits is ignored, ^ ^ 

1140 Read 'parameter' Ba of program to store starting at location S. 
^ Parameter 

Job title (10 words) 

1 Computing time estimate, iii seconds, in digits 

0-23 (One half-word) 

— wwv,viw^v/j^ u-ioin^ oDoojiittuc, ^uxit! na II — word ) 

3 Number of store blocks required, in digits 

1-11 (One lialf-word) 

4 'Parameter' in Job Description (One -half-word) 



5 



Logical tape numbers defined (8 half-words \. 
The 0^^ digit (0 < < 15) of the 5>^ 
half-word is a 1 if tape number 1 6 i + j is 
defined. 

6 Inputs defined (One half-word). 

The i"^^ digit (0 < i < 15) is 1 if input 
stream i is defined. 

7 Outputs defined (One half -word) As 6. 

1141 Define Compiler 

Ba = Tape Number to which the compiler is to be written. If Ba =r 127 
and If the compiler name specified (see below) appears in the Super- ' 
visor Directorj^, the compiler will be written to the current Super- 
^^^SL!^^^^ "^^ ^^^^ °^^® ^'^^^^ "^"^^ ^® "^^0 loop stops with J70707070 
(nee below^'' ^^^ ^^^^code .Till use 1143, 0, 0, 0.1 and 1143, 0, 0, 0.2 

The five half-words S to S+2 contain the following parameters: 

a) First four characters of name. 

b) Second four characters af name. 

c) Llain store starting Address (of where the compiler is now). 

d) Main store finishing Address (of where the c ompiler is now). 
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e) Actual main store starting Address (of where the compiler 
IS to be placed when in use), 

i) The compiler naine shouM be right justified within each half- 
;/ord, bux the first four characters should be put in the first 
Iialf-word, 

e,£. ABL = J004-I4254. 

- - - f 

HARTRAN =^ J504i 6264, J00624-156 
li) If the first four characters are zero, tlie second four will be 
used as the starting block address (digits to 21 ) of the com- 
piler on tape. This facility cannot be used when Ba = 127, 

iii) The starting address and the actual starting address should have 
bits 12 to 23 zero, and the starting address must be greater 
than zero, since the block before this is used to set up the 
compiler title block, 

iv) The following fatilt indications may bo printed: 

COMPILER ^mB NOT LISTED 

COJiPILSR NOW JJ/S T.AP;:J FAIL 

COMPILSR TOO BIG- 

larriNG- to spech^ud blocics on system 

TAPS IS PR0HI3IT::;D 

The f ijTst and third can only occur if Ba = 1 27. The fourth 
implies the facility described in Note (ii) has been used with 

1142 End compiling 

(i) If Ba^ O, set Conpile/Sxeoute . switch to Execute, and reduce 
stox-e allocation to that specified in Job Description. Lose 
all store bl.cks with block labels greater than or equal to 
digits 1-11 of ba, unless ba less than O, in which case lose 
no blocks. Transfer control to address n, unless n less 
"than O, in which case End Program,, 

(ii) If Ba = 0, do none of 1die above; the only effect of this 

extracode is then to inform the Supervisor that the copy of 
the compiler being used has been, or may have been, spoilt, 
so that a new copy must be brouglit from magnetic tape for any 
subsequent job. The Compile/Execute switch is not ciianged. 
x'his extracode is useful where a compiler may have been spoilt 
by an interlude. 

1143 Reserve Supervisor Tape 

Ba should be zero 

n should be 0.1, 0.2 or 0, with the following meanings: 

n= 0,1 The Supervisor will come to a loop-stop v^ith J70707070 in 
B120 waiting for the Write Permit switch to be switched on 
on the Supervisor tape* Mien this has }ieen done, the 
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n= 0.2 



n= 



program will be allowed to write to/ or read from, the 
Supervisor Tape (logical number 127), and nomal ise of 
T:ne tape (e.g. reading compilers) Y/ill be halted. 

?!!%^^o^'^^!°'* ^^^ """'^ ^° ^ loop-stop with J70707070 
^f on tlTt^ ^"^ ^^! ^-^ite Permit switch to be switched 
Off on the Supervisor tape, after which normal use of the 
Supervisor Tape will be resumed. 

The Supervisor Tape will be reserved as with N= 0.1 
but for reading purposes only. There will be no loop 
stop but 1143 0, 0, 0.2 must be obeyed after readiL. 
in order to release the tape for normal purposes. This 
facility is used if it is necessary to print out part 
of the Supervisor tape. 

An operator request will be necessary before using this extracode. 
1147 Call Compiler 

^^^ fnJl^i^ even (digit 23== 0), then n will be interpreted as a 
?^n^^r S^^"^? ^^ ^^ compiler in question vd.ll be called 
h^^ ^he Supervisor Tape and entered at the address specified 
P«^ ; f !,^^^^^i^ f the standarxi compilers is given i^ 
l^ w L?l,'^l""'"^^ ''^?^ (^-S 411). This facmty S 
Tu^uti^X -i^oxvxsor, ana oy programs using compilers as 

^^^ ^oc/b °f (^^^'^^ \3^ 1), the compiler will be called from 
block b of tape a, where a = digits 15 to 21 of n 

b = digits 2 to 14 of n 
It will be entered at ba. 

In both cases, if ba = 0, the Btandard entiy point will be used. 
With 1150 and 1151, ba, P and K are as defined in eedtion I2.t. 
1150 Assign ba blocks, labels P to (P + ba -1 ) to overflow K. 

Mnnv!'^''^Su^^c^"^^^^ ^ program or compiler to temporarily hand 
llZ t\ ^ Supervisor, which may write them to the system Sp 

blocks to beT ^.' "^Jt^'T. ^^'''^' ^^ *^^ P^°S^^ ^^-^ ^^ 
^W^ • ^^^ ^^ ^^°°^ ^^^^1^ a^^ retained in the 'over- 
jIL f "" ^t^^^^^^^^ t° this region must bear distinct labels. 
If ba = 0, one block is transferred. «ucxb. 

i151 Set up ba blocks, labels P onwards, from overflow K. 

This extracode recalls blocks previously written to the overflow 
^!!i:!:,^?,:;^^ ?5 ;^^^°^ ^ ^^^ting blocks having these labels are 
ovei^itten. If ba ^0, one block is recalled. If these blocks do 
not exist m the overflow region, the program is monitored. 

i156 Enter extracode control at n if the 'in Supervisor' switch is set. 
OMs extracode is used by various Supervisor Extracode Routines 
which are obeyed on main control. If the 'in Supervisor' switch 
is not set, the program will be monitored. 

1157 Enter extracode control at n if the 'Process' switch is set. 

This may onOy be used by Supervisor routines such as the monitor 
called m during the running of a main program. 
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Appendix B 
Notation 



Most symbols are used with two completely different meaninP'c; 

1 . ARITHMETIC 

Lower-case letters are used for suffices and for the content of 

resulfoTln ' '°?"'^°" ^"""^ "" upper-case letters. ?hr* °^ 
result of an operation is denoted by a prime Thn^ c -i ^\^. 

c^ntf^rof I. ^'"'*"" "^ ^^""^ *° *^- '^o"*-* ^-^--- plus the 
(a) Suffices 

a? the argument of the prefixed location 



U 



the exponent of the prefixed location 

two consecutive registers, starting with the 
one suffixed 



the register following that suffixed 
(b) Accumulator 



A 

al 

am 



^q\^^^ double-length accumulator, holding b.x 
79-hit mantissa aay and 8-bit exponent ay 

the 48-bit floating-point number formed from 1. 
Is and ay ' 



the 48-bit floating-point number formed from m and ay 
aq the single-length number which is obtained by 

standardising, rounding and truncating the contents 
of the accumulator 

L the less-significant half of Aoj, of 39 bits with 
no sign 

Ls the sign bit associated with L 

M the more-significant half of Aa?, of 40 bits, the 

most-significant bit being the sign digit 
AO accumulator overflow 
DO division overflow 
E or EO exponent overflow 
Q standardised 

R J?"""?^^' ^y forcing a 1 in the least-significant 
digit of M if L is not clear 

R+ rounded, by adding a 1 to the least-significant 

digit of M if the most-significant bit of L is a 1 
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(c) General 
B 
Ba 



any B-registor (index register) 

the B-register specified by the 3a digits of an 
instruction 

Be the B-carry digit 

Bm the B-register specified by the Bm digits of an 
instruction 

Bt the B-test register 

C the main control register (B127) 

C() the contents of the location specified within 
the brackets 

E the extracode control register (B126) 

F the function digits of an instruction 

^^ *lie logical accumulator (B98 and B99) 

I the interrupt control register (B125) 

the unmodified address part of an instruction 
(a 24-bit number with the point one octal place 
from the least-significant end). 



N 



n 



the modified address part of an instruction 
regarded as a 24-bit number with the point one 
octal place from the least-significant end 

S the address of a store location. A full-word 
address in accumulator instructions (digits 
21-23 ignored), a half-word address in B-register 
instructions (digits 22 and 23 ignored), or a 6-bit 
character address (all digits relevant) 

V the V-store 



Va 
X 



register a of the V-store. 

signifies extracodes suitable for fixed-point 
working. 



2. BASIC LANGUAGE 



xn practice no distinction is made between capital and small 
letters, though capitals are used here. However, as an aid 
to clarity, it is sometimes advantageous to use lower case 
letters for the separators ra, n, v, x and q. Small Greek 
letters a , 3 , are used for 21 -bit decimal integers, k for 
the octal number in the 3 least-significant digits of a 24-bit 
address, and a for a general octal number of up to 8 octal 



digits. 
Aot 
B 



Parameter a, (o < a < 3999), of the current routine 

An operator in an expression, causing bits 12-23 
of the previous element to be set to zero 
i.e. it gives a "Block Address" 

Introduces a string of characters on the next line 
which are translated into internal code and 
placed in successive character positions 
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Da 

E 

ER 

EX 
F 

Ga 
H 

JO 

Ko 



S 



Uot 



Ua 
Ua-e 



B/3 



An operator, causing the previous element to be 
logically shifted down a places 

The enter directive, causes the compiler to 
evaluate any used parameters etc,- ±rser^-t. l-!>>r=»r-' 
routines, delete the compiler and enter the program 

As E but the compiler is not deleted and may be 
used again ^ 

The enter interlude directive, to enter a short 

- - — ^ *« " v^uj. a.ii£j t.ne uompiiing process 

Introduces one or more floating-point numbers on 
a line, after some expressions otherwise 
interpreted. Also, if necessary, increases * to 
the next full-word address 



Global Parameter a (o < a < 3999) 

Subsequent expressions on a line are interpreted 
as 2^-bit words and, if necessary, * is increased 
to the next half-word address 

a is octally justified to the left, i.e. the most- 
signif leant digit goes into bits 0-2, the next 
into 3-5 etc, 

is octally justified to the right, to bit 20 
"t'^'^^^^^^^^^'^^&^^^^^^nt digit goes into bits 
15-20, the next into 15-17 etc. 

K^.k As Ka , with k going into bits 21-23 

La.k Library routine number a, copy k. (.k is omitted 
II only one copy of the routine is wanted) 
( a = 1 to 1999, k = 1 to 1999) 

M Alternative to & 

N A Ser>aTa+:nr' t.TVi-i />V> -^^^ J 1 

^_^_ ....^^xx x^uxi-ci^uj-vcixences xne element 

before it with the element after it in an 
expression 

Pa Preset parameter a (O < a < 99 normally) 

^ A separator in an expression which divides the 
element before it by the element after it, 
placing the result in digits 0-20 

A directive defining the beginning of routine 
a (0 < a < 3999) 

Expressions after the directive S are interpreted 
as 6-bit characters, i.e. only bits 15-20 of the 
expression are used 

Ta or 

Ta-6 ^^^ title is copied to output channel a or 
channels a to 6 inclusive 



An operator causing the previous element to be 
logically shifted up a places 

or Unset preset parameter a, or a to 3 inclusive 
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Uh 



V A separator in an expreasicn. The element before 
it is OR-ed with the element after it 

W An operator ir, an expression, causing bits 0--1 1 
of the previous element to be set to zero, i.e. 
it gives an address within a block 

X A separator. The elenent before it is multiplied 
by the element after it "" 

Ya a is placed in bits 0-23 (instead of bits 0-20) 

Z A directive indicating the end of a routine 

* The address ::f the first character position in the 
location where the item is placed. If used in an 
expressior. on the right-hand side of a directive, 
then * is the address of the next character 
position 

I All subsequent characters up to NL are ignored 
(I is not a terminator) 

£,^ Alternatives to | 

[ ] All characters between square brackets are 

ignored. Bracket nesting to any level is allowed 

, Alternative to multiple space as a terminator 

& A separator which logically ANDs the element 
before it v/ith the element after 

I a special separator used in 

(a) an element a .8 a modulo 2}^ goes to bits 
0-11 and 6 nodulo 2^^ to bits 0-20, added to a 

(b) a florfcing-point number N (o : 0) : y 
where the value of the number is N x 10°' x 8^ 
and the exponent is forced to Y or standardised 
if Y is omitted 

/ (a) in a parameter, / separatao the parameter 
nui-iber and routine nuniber 
(b) an alternative to : 

'(prime) an operator which forms the logical binary 

complement i.e. it replaces 1's by O's and O's 
by 1 's 

? (a) in the context A a ? = expression, A a is 
only set to the given expression if no other 
definite setting of A occurs before the program 
is entered. 
Similarly for G ? = expression 

(b) in the context P a ? = expression, P a is 
set equal to the given expression unless P a is 
already set, in whic! . case the directive is ignored 

(c) in the context ? expression, causes the 
compiler to ignore the remainder of the line if 
the value of the expreosion is sero. 
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Appendix C 

V-Store Addresses of Peripherals 

Each peripheral is allocated one or more words in a part of 
the /-store associated with its particular type of equipment. 

A V-store address is identified by having 6 as its most- 
sxgnif leant octal digit; furthermore, since onlv the nn-rp> 
^^^f^V^'^T^l ha-Ll -words are used, the least-significant octal 
digit of the address is always zero. 

That part of the V-store associated with the peripherals is 
the first 256 words of the block beginning with J6004. 

To each type of equipment there corresponds l6 consecutive 
Iddress^° peripheral p of type q is allocated the V-store 

j6oo4 + l6q + p. 
The type number q is defined in the follov/ing table :- 

q Equipment 



3 

k 

6 

7 
8 

9 
10 
11 



Card Readers 

Spare (London only: 
High Speed Data Link) 

TR7 Paper Tape Readers 
and N.S.P, Tape 

Graphical Outputs 

Anelex Line-printers 

I.B.M. liagnetic Tape 

Fast Paper Tape Punches 

TR5 Paper Tape Readers 

Teletype Punches 

Card Punches (and, 
Manchester only, 
X-ray Diffractometer) 

Spare (Manchester only: 
A»T. & S. On-Line Data 
Links ) 

Teleprinters 



V-store address of 
equipment of each type 

j6oo4oooo 

J60040200 
J6004o400 
J6004o600 

j6oo4iooo 

J60041200 

j6oo4i4oo 
j6oo4i6oo 
J600420D0 
J60042200 

J60042400 

J60042600 



indicat^r^'^^ ^^""^^ ^^^ ^^^ "^°^ equipnient of the type 
indicated. Card T^eader 1, for example, wo^ild be addressed 
by writing J60040010. , / -lv.. ue av-c.r...ooeci 
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Appendix D 
Character Codes 

The following table lists all the available Atlas Internal 
Code characters together with their external representations 
m terms of punchings on y-track tape, 5-track tape, and 
punched cards, using the standard Atlas character codes for 
these media. 

The 7-track tape code is the I.C.T./Ferranti Orion/Atlas code. 
The 5-track code is the standard I.C.T./Ferranti code as used 
on Pegasus, Mercury, Sirius, Atlas and Orion. The card code 
IS the Atlas Fortran card code. 

Also in the table is an indication of which characters are 
available on the Anelex Line-Printer, 

Some characters are designated "UnassigTied" . This indicate^ 
that no external printing characters have been assigned to 
these Internal Code characters. Most compilers and Input 
Routines treat these as Illegal Characters, However, these 
characters have had 7-track paper tape punchings assigned to 
them. This serves two purposes: (i) it means that, if at 
some later date characters are assigned to these paper tape 
puncnings, then Internal Code characters are available and 
assigned to correspond to them, and (ii) it means that, since 
there is some internal representation for every 7-track paper 
tape code with odd parity, it is possible to use Internal Code 
representation for parity-checked "binary" information, rather 
than use pure "Binary" mode. However, it should be noted that, 
since the Supervisor treats the shift characters and the 
New Line characters in a special manner, the internal 
representation will not be an exact "image" of the external 
punchings. It should also be noted that some of these 
Internal Code characters are used by non-standard exteraal 
codes to represent non-standard characters. Thus in all cases 
special care should be taken in using these characters. 

One character (Outer Set 02) is designated "Spare". This 
character has no external printing assigned to it nor any 
7-track paper tape code. It may however be used by non-standard 
external codes, and thus care should be taken over its use. 

Internal Code character 00 (inner and Outer set) is designated 
"Not Assigned". This character is reserved for special 
purposes by the compilers and the Supervisor. It will never 
have a character assigned to it, and should never be used by 
normal programs. 

Certain characters are not available as standard on any input 
medium, and may be treated as "spare" by input routines (for 
example, LI 00 treats than thus). They are 

Outer Set 03 £ 
Outer Set 35 10 
Outer Set 36 11 
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They have the meaning: as shown when usod as output characters 
destined for the line-printer. 

Certain other characters iiave alternatives given in 
parentheses. This is because the characters are alternatives 
xn one or more of the relevant external codes. (For example. 
Inner Set 13 is listed as ir or £; these are alternatives on 
, -track tape, 5-track tape and cards.) However, in the case 
ol tne line-printer, only the first character so listed is 
relevant, and, except for /o, the other character appears 
elsewhere in the table for line-printer purposes. 

Note that, in the column for 5-track tape, the 5-track tape 
code is given with the sprocket hole after two information 
holes and not three. This is the reverse of the normal 
convention and is done because the form as printed corresponds 
to the internal binary representation of the character when 
"Binary" mode for Input or Output is in use. 

The Fault character (77 Inner Set) has no external 
representation. It is used under certain circumstances on 
input oy the Supervisor as a translation of any external 
character which has no Internal Code representation. 

Tabulate (02 Inner Set) is treated as a single space by the 
Supervisor on output equipment where it does not otherwise 
exist. 

The external shift characters (06 and 07) are ignored by 
the Supervisor for equipments where they have no relevance 
(e.g. the line-printer). 

The fifteen symbols 

: • [ ] < > = « i ? , 2 a 6 ir 

are on the fourth quadrant of the line-printer wheel. Tf none 
of these symbols are used in a line, the time to print the line 
^s "L. minute; other^rise it is 1 minute 

■'•000 " ' ■' 

sit 



Notation: 



FS Figure Shift 
LC Lower Case 
LS Letter Shift 
UC Upper Case 

** A paper-tape character appearing in both shifts 
• . The character cor-cemed is not available on this 
peripheral. 
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internal Code - Innft-r Set 



Character 

(Not Assigned) 

Space 

Tabulate 

Backspace 

Shift to outer set 

Shift to inner set 

Shift to LG/IS 

Shift to UG/FS 

( Open brackets 

) Close brackets 

) Comma 

T (£) Pi (Pounds) 

? Queiy 
& Ampersand 
* Asterisk 
/ Oblique 

Zero 

1 

2 

3 

U 

5 

6 

7 



< Less than 
> Greater than 
= Equals 
+ Plus 
- l^nus 
• Point 



Internal 

code 

(octal) 

00 
01 
02 
03 
04. 
05 
06 
07 

10 
11 
12 
13 
U 
15 
16 
17 

20 

21 

22 

23 

24. 

25 

26 

27 

30 

31 

32 



7-traGk code 

(binary bits 

and case) 



** 0010-000 
** 0000.100 
** 0010.101 



5-track code 

(binary bits 

and shift) 



■P!^ m lies 



Atlas Fortran 

card code 
(holes punched) 



Anelex 



Line-Printer 
(availability) 



3U 
35 
36 
37 



** 0010.110 
** 0000.111 

LC 0111.000 
l^ 0101.001 
LC 0101.111 
LC 0111.011 
LC 0101.100 
LC 0111.101 
LC 0111.110 
UG 0011.111 

UO 0100.000 
UG 0110.001 
UC 0110.010 
UG 0100.011 
UC. 0110.100 
UC 0100.101. 
UG 0100.110 
UC 0110,111 
UG 0111.000 
UC 0101.001 
LC 0100.011 
LC 0110,100 
LC 0100.101 
UG 0111,101 
UG 0111.110 
UG 0101.111 



** 11.011 
** 00.000 

FS 10.100 
FS 01.100 
FS 11,110 
LS 01.111 
l^ 10,111 

• • 
FS 11.000 
FS 11,101 

FS 00.001 
FS 10,000 
FS 01,000 
FS 11,001 
FS 00,100 
FS 10,101 
FS 01,101 

re u.ioo 

FS 00,010 
FS 10.011 

• • 

FS 10,001 
FS 01,010 
FS 01.011 
FS 11.010 
** 00.111 



0,8,4 

10,8,4 

0,8,3 

11,8,3 

11,8,5 

8,5 

11,8,4. 

0,1 


1 

2 

3 
U 
5 
6 

7 



0,8,5 
10,8,5 
S,3 
10 

11 
10,8,3 



les 
les 
les 
les 
les 
Yes 
les 
les 

les 

V 

les 
les 

les 

lea 

les 

res 

les 

Yes 

les 

les 

Yes 

Yes 

Yes 
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Innor sot 
Character 



(continued) 

Internal 

code 

(octal) 



' Prime (alternative : 
n (letter n) on 4.0 
5-track tape only ) 



DA 



7-tracIc code 5-track code 

(binary bits (binary bits 

and case) and shift) 



LG 0100,000 FS 10.111 



3 
C 

D 



H 
I 
J 
K 
L 
M 
N 


P 

Q 

R 
S 
T 
U 
V 

w 

X 
Y 

z 

(Unas signed) 
(Unas signed) 
(UnassigtiQd) 
(Unas signed) 
Fault 



41 
4-2 
4-3 
4^ 
4-5 
4-6 
47 

50 
51 
52 
53 
54 
55 
56 
57 

60 
61 
62 
63 
64 
65 
66 
67 

70 
71 
72 
73 
74 
75 
76 
77 



UC 1010.001 
UC 1010.010 
UC 1000.011 
UC 1010.100 
UC 1000.101 
UC 1000.110 
UC 1010.111 

UC 1011.000 
UC 1001,001 
UC 1001,010 
UC 1011.011 
UC 1001,100 
UC 1011.101 
UC 1011.110 
UC 1001.111 

UC 1110,000 
UC 1100.001 
UC 1100.010 
UC 1110,011 
UC 1100.100 
UC 1110,101 
UC 1110,110 
UC 1100,111 

UC 1101,000 

UC 1111.001 

UC 1111.010 

(UC 1101.011) 

(UC 1111.100) 

(UC uoi.ioi) 

(UC 1101,110) 



LS 10.000 
LS 01.000 
LS 11,000 
LS 00,100 
LS 10,100 
LS 01.100 
l^ 11,100 

LS 00,010 
IB 10,010 
LS 01,010 
IS 11.010 
LS 00,110 
LS 10.110 
LS 01.110 
IS 11,110 

LS 00,001 
IS 10.001 
15 01,001 
LS 11,001 
IS 00,101 
LS 10,101 
I^' 01,101 
LS 11,101 

l£ 00.011 
LS 10,011 
LS 01.011 



Atlas Fortran 

card code 
(holes punched) 



8,4 

10,1 
10,2 
10,3 
10,4 
10,5 
10,6 
10,7 

10,8 

10,9 
11,1 
11,2 
11,3 
11,4 
11,5 
11,6 

ll.V 

11,3 

11>9 
0,2 
0,3 
0,4 
0,5 
0,6 

0,7 
0,3 
0,9 



Anelex 

Line-Printer 

(availability) 



Yes 

Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 

Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 

Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 

Yes 
Yes 
Yes 
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Character 

(Not Assigned) 

Space 

(Spare) 

£ Pounds 

Shift to outer set 
Shift to inner set 
Shift to LC/13 
Shift to UC/FS 

(Unassigned) 
(Unas signed) 
(Unassigned) 
(Unassigned) 
Stop 
Punch On 
Punch Off 
: Colon 



Internal Code ■» Outer Set 

Internal 7-track code 5-traclc code Atlas Fortran 

^code ^ (binary bits (binary bits card code 

(> octal) and case) and shift) (holes punched) 



00 
01 
02 
03 
04 
05 
06 
07 

10 
11 
12 
13 
1-4 
15 
16 
17 



^ (x) Phi (letter x) 20 

[ Open square bracket s21 

] Close square 22 
brackets 

■*■ Arrow 23 

> Greater than or 24 
equal 

f=^ Not equal 25 

_ Underline 26 

I Vertical bar 27 

^ (^ Superscript 2 30 
(Percent) 

- (v) Curly equal 31 
(letter v) 

a (10) Alpha (Ten) 32 

B (11) Beta (Eleven) -^3 

i Half 34 

10 Ten 35 

11 Eleven 36 
(Unassigned) 37 



»* 0010.000 FS 01.110 



** 0010,110 ** 11.011 
*^^ OOOC.lll ** 00.000 

(** 0001.000) 
(*« 0011.001) 
(** 0011.010) 
(*« OOQL.Oll) 

^^ 0011.100 

** 0001.101 

** 0001.110 

LC 0011.111 



FS 00,011 



LC 0110.001 
LC 0110.010 



FS 00.101 
FS 01.001 

FS 10.010 



LC 0100.110 
LC 0110.111 
LC 0101.010 



UC 0101.010 
UG 0111,011 
UC 0101.100 



(UG 1000,000) 
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FS 00,110 



None 



.6,8 

• • 
11,7,6 



10,6,8 
10,7,8 



Anelex 

Llne-I¥inter 

(availability) 



les 



Yes 



les 

• « 
les 



leg 
les 
les 



Yes 
les 
les 
les 

les 
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Outer set (contJnucd) 

I'^'^^^i'nal 7-track code 5-track code Atlas Fortran Anelex 
oharactcr code (binaiy bitn (binaiy bits card code Line-Printer 
(octal) and case) and shift) (holes punched) (availability) 



(Uns 


.ssigned) 


AO 


(LC 1000,000) 


• • 


a 




a 


LO 1010,001 


. . 


b 




42 


LG 1010.010 


• • 


c 




43 


LC 1000,011 


• * 


d 




44 


LC 1010.100 


» t 


e 




45 


LG 1000.101 


• • 


I 




46 


LC 1000,110 


• • 


r" 




47 


LC 1010.111 


• • 


h 




50 


LC 1011,000 


• • 


- 




51 


LG 1001.001 


• • 


J 




52 


LC 1001.010 


• • 


j\ 




53 


m 1011.011 


• • 


1 




54 


LG lOjl.lOO 


• • 


m 




55 


LC 1011,101 


• , 


r 




56 


LG 1011.110 


• • 







57 


LG 1001 au 


• • 


P 




60 


LC 1110.000 


• • 


q 




61 


LC 1100.001 




r 




62 


LC 1100.010 




s 




63 


LG 1110.011 




a. 




64 


LC 1100.100 




u 




65 


LC 1110.101. 




V 




66 


LO 1110.110 




'.■; 




67 


LC 1100.111 




y*. 




70 


LG 1101. OCX) 




-r 




71 


LC 1111.001 




z 




72 


LC 1111,010 




(Unas 


sippQcd) 


73 


(LG 1101,011) 




(ona. 


■:igned) 


74 


(LC 1111.100) 




(Unas 


signod) 


75 


(LC 1101. lOl) 




(Unas 


signed) 


76 


(LG 1101.110) 




Srasc 




77 


** 1111.111 *» 


11.111 
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Appendix E 

Sunmary of Sxtracodes 

Allocation of Function Numbers 

There are 512 function numbers available for extracodes, 
1000-1777. Of these, 1000-1477 are singly-modified instructions 
i.e. B-type, and 1 500-1 777 are doubly-modified i.e. A- type. 

The extracodes are divided into sections as shown below: 

1000 - 1077 Peripheral routines. 

1100 - 1177 Organisational routines 

1200 - 1277 Test instructions and character 

data-processing. 

1300 - 1377 B-register operations. 

1400 - 1^77 Complex arithmetic, Vector 

arithmetic, and other B-type 
accumulator functions, 

1500 - 1577 Double-length arithmetic and 

accumulator operations using the 
address as an operand. 

1600 - 1677 Logical accumulator operations, 

trigonometric routines and half- 
word packing. 

1700 - 1777 Logarithm, exponential, square root 

etc., and miscellaneous arithmetic 
operations, 

Wliere possible, the last two r»o-hai •Piino+--? rwi ^-ir,.-,'+^ ^^^-^^„- 1 

to those of similar basic operations. 

The extracode function is listed at the left of the page and 
followed by a reference and a description. The number of 
basic instructions pbeyed is given at the ri^t jaX the pa^e„ 
This number includes the extracode instruction and its entry 
in the jump table; where necessary a range or formula is 
given , 

The extracodes are listed in numerical order, and are also 
classified by type; some extracodes are tlierefore given twice, 

Extracode Ref , Description Instructions 

Obeyed 
Organisational and Peripheral Extracodes 

E, 1 Magnetic tape 

Block Transfers 



a 



1001 9.3.1 Search for section n on tape B^ 

1002 9.3.1 Read next K+1 sections from tape 

Ba to store blocks, P, P+1 . , . , , P+II 

1003 9.3.1 Read previous K sections from Ba to 

P+K , P. 

1004 9.3.1 Write P, P+1,.., P+K to next K+1 

sections on Ba 
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Extra c ode Rpf . Do script ion Instructions 

Obeyed 

1005 9.3«1 r ove tape Ba forwards K+1 sections 

1006 9.3.1 Move tape Ua back^'fards K+1 sections 

Organisational Instructions 

1007 9.5.1 Mount next reel of file Ba 

1010 9.5.1 Mount 

101 1 9.5.1 Mount free 

1012 9.5.1 Mount on logical channel K 

1013 9.5.1 Mount free on logical cliannel K 

1014 9.5.2 Vrite title 

1015 9.5.2 Read title or number 

1016 9.5.2 Unload 

1017 9.5.2 Free tape 

1020 9.5.2 Release tape (pass to another program) 

1021 9.5 .2 Release mechanisms 

1022 9.5.2 Re-allocate 

1023 9.5.2 Hox^ long? 

1024 9.5.2 Where am I? 

Variable Length Organisation 

1030 9.4.2 Start reading forwards 

1031 9.^.2 Start reading backxvards 

1032 9.4,2 Start writing forwards 

1033 9.4,2 Select tape Ba 

1034 9.4.2 Start reading forwards from fixed 

blocks 

1035 9.4,2 Start reading backwards from 

fixed blocks 

1036 9.4.3 ba ' = selected magnetic tape 

1037 9.4,3 s' = mode of magnetic tape Ba 

Variable Length Transfers 

1040 9.4.3 Transfer 

1041 9.4.3 Skip 

1042 9.4.3 Mark 

1043 9.4.3 Stop 

1044 9.4,3 "^-^ord search 

1046 9.7 Read next block on Orion tape 

1047 9.7 Read previous block on Orion tape 

, 2 Input 

1050 8.4 Select input n 

1051 S,4 Find selected input 

1052 8.l4 Find peripheral equipment number 

1053 8,l4 Test whether binary or internal 

code 

1054 8,l4 Read next character to Ba, Jump to 

n at end of record 
ba ' = number of blocks read 
Read ba half-words to S 
Read next record to S 



1055 


8.14 


1056 


8.14 


1057 


8,l4 
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Extracode Ref. 



E.3 



Output 

1060 
1061 
1062 
1063 
1064 
1065 
1066 



1070 
1071 
1072 



8.4 

8,15 
8.15 

8.15 
8.15 
8.15 

8.15 
8.15 
8.15 



Description 



Select output n 

Find selected output 

Find peripheral equipment type 

Delete output n 

Write character n 

End this record 

Write ba half-words from S 

Mnu© a record from S 

Rename output n as input ba 
Bieak output n 
Define output n 



Instructions 
Obeyed 



^ Subroutine Entry 



1100 
1101 
1102 
1362 



7*7 Enter subroutine at s, ba' = c+1 

7 #7 Enter subroutine at S, ba' = c+1 

7»7 Enter subroutine at bm, ba' = c+1 

7.7 Enter subroutine at n, b90 ' = c+1 



Branching 

1103 
1 104 
1105 



1 106 
1107 



12.3,2 Establish 3a branches 

12,3,2 Start branch Ba at S 

12,3,2 Kill Ba. If Ba = 64 kill current 

branch 
12,3.2 Halt current branch if Ba is 

active 
12.3,2 Jump to n if Ba is active 



Monitor 

1112 11,3 Set Monitor .lump to n 

1113 11.4,1 Do not restart 
1117 11.1.3 End program 



Mj scellaneoij.s Transfers 

T"i~m --— 3--- 

1121 7,8 

1122 12,4 

1123 12,4 
1136 12.4 

1124 7,8 

1125 7,8 

1126 12,9 

1127 12.9 



ba ' = clock 

ba' = date 

ba' = local instruction counte-r 

set instruction counter = n 2048 

Read instruction counter 

v6' = n 

ba' = v6 & n 

v7' = n (hoot) 

ba' = v7 & n (read handcwitches) 



5 Traps 

1131 
1132 

1133 
1134 

1135 
1 136 



7.5«2 See E,12 Character Data Processing 

11.2 Set trap/normal mode 

11,2 ba' = trap address 

11.2 Trap 

12,1 See E.10 Store 

12.1 See E,7 Miscellaneous Transfers 
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E/k 

Extracode Ref , Description Instructions 

Obeyed 

E , 9 Compiler and Supervisor 

11^0 12.9 Read parameter Ba to s 

1141 12,9 Define Compiler 

11 42 12.9 Snd compiling 

11^3 12.9 Reserve Supervisor Tape 
11^7 12.9 Call compiler n 

1150 12.9 Assign ba blocks, labels P to 

(P + ba-l), to overflow K 

1151 12,9 Set up blocks P onwards from 

overflow K 

1155 12.1 See E.IO Store 

1156 12.9 iSnter extracode control at n if the 

"In Supervisor switch" is set 

1157 12.9 Enter extracode control at n if the 

"Process switch" is set 



Jump to n when block ^ ba defined 

Find smallest block label defined 

Read block P 

Release block P 

Duplicate read 

Duplicate write 

Rename 

Tfrite block P 

Read to absolute page 

Lose block P 

Clear blocks 

Store allocation = n blocks 

ba' = nuLibex" of pages available 

ba' = number of blocks available 

Reserve band n 

Read K + 1 blocks 

¥rite K + 1 blocks 

Lose band n 

Arithmetic and Lo^^ical Extracodes 

Accumulator operations are rounded floating-point unless marked 

X, when they are suitable for fixed-point working. 



E.10 


Store 






1135 


12.1 




1155 


12.1 




1160 


12.1 




1161 


12.1 




1162 


12.1 




1163 


12.1 




1164 


12.1 




1165 


12.1 




1166 


12.1 




1167 


12.1 




1170 


12.1 




1171 


12,1 




1172 


12.1 




1173 


12.1 




1174 


12.1 




1175 


12.1 




1176 


12.1 




1177 


12.1 



E.11 Tests 










1200 


7.6.1 


ba' = n if AO set; clear AO 




9 


1201 


7.6.1 


ba' = n if AO clear; clear AO 




7 


1204 


7.5.3 


See S.19 Logical Operations 






1206 


7.6.2 


ba' = n if most-significant 
character in g = 




4 


1216 


7.6.2 


ba' = n if bm > 




5-6 


1217 


7.6.2 


ba' = n if bm < 




4-5 


1223 


7.6.2 


ba' = n if Be = 1 




4 


1226 


7.6.2 


ba' = n if bt > 




4-6 


1227 


7.6.2 


ba' = n if bt < 




3-5 


1234 


7.6.1 


c' = c + 2 if am approximately 


= s 


11-12 


1235 


7.6.1 


c' = + 2 if am not approximat 


ely 


= s 
11-12 
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E/5 



Extracode Ref . 



Description 



Approximate equality is defined by 



ani'-s 



<C(ba), with am standardised 



Instructions 
Obeyed 



If am - 0, am is not approximately = s 



1236 
1 oorr 

1256) 

to ) 

1253) 
1255 

1265 
1727 

1736 
1737 



7.6,1 
7.5.2 

7.6.1 

7.5.3 
7.6.1 

7.6.1 
7.6.1 



ba' = n if ax > 

Wdr ■ •— Ai J. i i%J^ "^ \J 

See E.12 

Character Data Processing 

ba' = n if m is neither zero nor 

all ones 

See E.19 Logical Operations 



4-6 



I _ 



c+1,c+2, orc+3as 



am > , = or < s 

c»=c+2iflam|>s 
c« =c + 2ifjam|<s 



E. 12 Character data processing 

1131 7.5.2 Table search 

In 1250 and 1251, S is taken as a character address 

1250 7.5.2 ba' (digits 18-23) = s, 

ba' (digits O-I7) = 

1251 7.5.2 s« = ba (digits I8-23) 

1252 7.5.2 Unpack n cl-iaracters starting from 
character address C(Ba), to half- 

16 + 
int.pt. (6-|n) 



8+6n 



7-10 
11-18 



1253 7.5.2 



words from c(0a*) 

Pack n characters starting from 
half-word address 
character address 

E, 13 B-register operations 



half-word address C(Sa^), to 

c(Ba) 



18 + 5n 



1300 7.5.1 ba' = integral part of s, 

am' = fractional part of s 10 

1301 7,5.1 ba» = integral part of am, 

am' = fractional part of am 9 

1302 7.5.1 ba' = ba.n, rounded away from zero 23-24 

1303 7.5.1 ba' = -ba.n rounded away from zero 22-23 

1304 7.5.1 ba' = integral part of (ba/n) , 

b97' = remainder 25-28 

In 1302-1304, ba and n are 21 -bit integers in digits 0-20 

1312 7. 5.1 ba' = ba.n 23-24 

1313 7.5.1 ba' = -ba.n 22-23 

1314 7.5.1 ba' = integral part of (ba/n) 

b97' = remainder 25-28 

In 1312-1314, ba and n are 24-bit integers 
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E/6 



Extracode Ref, 



Description 



13^0 
1341 
13^2 
1343 
1344 

1345 

1347 
1353 

1356 
1357 
1362 
1364 

1371 
1376 
1377 



7.5. 

7.5. 

7.5. 

7.5. 

7.5. 

7.5. 

7-5. 
7.5. 

7.5. 
7.5. 
7.7 
7.5. 

7.5. 
7.5. 
7.5. 



ba' = ba. 2" ; unrounded 

arithmetic shift right 

ba' «■ ba, 2^ ; unrounded 

arithmetic shift left 

ba* = ba circularly shifted 

right n places 

ba» = ba circularly shifted 

left n places 

ba' = ba logically shifted 

right n places 

ba' = ba logically shifted 

left n places 

s' = s V ba 

ba* = position of most-significant 

1 in bits 16-23 of n (as B123) 

bt * = ba ^ s 

bt' = ba ?4 n 

See E.4 Subroutine Entry 

ba' = (ba & n) v (bn & n); 



Instructions 
Obeyed 

10-22 
9-21 

10-19 

9-18 

10-21 

9-20 
5 

7 
7 
5 






1 \ 



b121 » = Ba, b119' = N + bm 
bt» = ba & s 
bt' = ba & n 



E. l4 Complex arithmetic 



The complex ac 
registers, the 
If Ba = 0, Ca 
Ca may coincid 
with it. A is 



cumulator, Ca, is a pair of consecutive 
first register having address ba» 

is locations 0,1. s: is a number pair. 

e with S: but not otherwise overlap 
spoiled. 



l400 
l402 
1403 
l407 

l4lO 
I4l1 
l4l2 
l4l3 
l4l4 

1415 

1420 
1421 
1424 
1425 
1456 
1462 



7.4.6 
7.4.6 
7.4,6 
7.4.2 

7.4.6 
7.4.6 
7.4.6 
7.4,6 
7.4,6 
7.4.2 

7.4,6 
7.4,6 
7.4.6 
7.4.6 
7.4.6 
7.4.6 



ca' = log s: 

ca ' = exp s : 

ca ' = conj s: 

See E,l6. Miscellaneous B-type 

accumulator operations 

ca' =*| s: 

= arg s : radians 

= mod s: 

= s cos s*, s sin s* 

= 1/s: 

See E,l6. Miscellaneous B-type 
accumulator operations 



140 
5 



am' 
ca' 
ca' 
ca' 



^iax.117 
53 
15 



Max, 
95 



ca 



f - 



ca ' = 
ca' 
ca' 
s: » 
ca' 



ca + 
ca - 
s: 
-s : 
ca 
ca. s: 



s: 
s: 



8 
8 
6 
6 

5 
18 
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9 


+ 


kn 


9 


+ 


4n 


10 


+ 


i^n 


10 


+ 


^n 


13 


-f 


3n 



E/7 

Extracode Ref. Description Instructions 

Obeyed 

E,15 Vector Operations 

The vectors are of order n, si is stored in consecutive 
locations from ba, and So from ha.* ^ A is spoiled* 

1^30 7.^.7 % ' = Si + s 2 

1^31 7.^,7 % ' = Si - s 3 

1^32 7.^.7 Si' = am. s 2 

1^33 7.^.7 Si' = Si + am. sg 

n-i 

1^36 7.^.7 am' = 2 s^.. s,* 10 + 5n 

i=0 ** 

n-i 
1^37 7.^.7 a' = s Sii. 83^ 10 + I3n 

i=0 

E,l6 Miscellaneous B~type accumulator operations 

1^07 7.^ #2 Remainder and adjusted integral 

quotient l4-31 

1^15 7 •^•2 Generate pseudo-random number 

l44l 7.4.5 See E,l8. Arithmetic using address 
as Operand. 

1452 7.4,3 m' = m.saj. s'^V^^y^^y, ay' = bay 19-23 (x) 

1456 ) 

l462) 7.4,6 See E.l4, Complex arithmetic 

1466 7.4.2 a' = C(N+bm+ba) xC(N+bm) + a 18 

r 

1467 7«4«2 am' = 2 s.a; where 5c = am, 

i=0 ^ 

S^ = S+i, r = ba 6 + 3n 

1473 7.4.3 m' = (aa:/s a;) ,8^^'^^^^V ay' = bay 24^28 (x) 
1^/'+ /.'+.J u^oa;' = quorien-c (an/s;, 

am' = remainder 20-29 (X) 

1475 7.4,3 C(ba)' = quotient (a/s) , 

am' = remainder 19-28 (X) 

1476 7.4,3 C(ba)» = quotient ( f integral 

part of amj/s), am' = remainder 28-37 

E. 17 Double-length arithmetic 

Tlie double-length number is s: = s + s* where 

sy- 13 > s*y. s* and al are assumed to be positive 



numbers , 



7.4,4. a' = a + s: 10 

7.4,4. a' = a - s: 10 

7.4,4. a' = a + s: l4 

7.4.4 a' = s: 4 

7.4.4 a' = -s: 3 

7*4,5 See E,18, Arithmetic using address 

as Operand 
7.4.4 a'=:a.s: 15 

7.4,4 a' = -a,s: 19 

7.4.4 a:' =:a 5 

7.4.5 See E,l8, Aritlimetic using address 
as Operand. 
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E/8 



Extracode Tletf 



Description 



1565 
1566 

1567 

1574) 

1575) 



7. 4.4 
7.4.5 



a» 

a» = 
a» = 



s= -a 
al 
s: 



Instructions 
Obeyed 

5 
5 



1576 7.4.4 



See E.I8 Arithmetic using address as 

Operand 

a ' = a/s I 1 9 



E,l8 Arithmetic using address as Operand 

The address is taken as a 21 -bit integer with one octal 
fractional place. Fixed-point operations imply an 



exponent of 12, 



l44l 
1520 
1521 
1524 

1525 
1534 
1535 
1562 
1574 
1575 



7.4.5 
7.4.5 
7.4.5 
7.4.5 
7.4,5 
7.4.5 
7.4.5 
7.4.5 
7.4.5 
7.4.5 



saj' 
am' 
am' 
am' 
am' 
am' 
am* 
am' 
am' 
am' 



= ba, sy' = 12 
= am + n 
= am - n 
= n, 1' = 
= -n, 1' =0 
= n, 1' = 
= -n, 1' « 
s am.n 
c am/n 
= aq/n 



The 1< 
1204 



1265 7.5.3 



E,19 Logical accumulator operations 

.ogical accumulator G is B98 and B99 

7.5.3 ba' = number of 6-bit characters 
from most-significant end 
identical in g and s 
g' = 2^g + n, ba' = 6-bits 
shifted out of g 
g' = s 
g' = g + 8 

= g + s with end around carry 

= g / s 

= g & s 

= 1 

= e 



1601 

^6ok 

1605 

1606 

1607 

1611 

1613 

1615 

1624) 

1626) 

1630 

1635 

1646 

1652 



7.5.3 
7.5.3 
7.5.3 
7.5.3 
7.5.3 
7.5.3 
7.5.3 
7.5.3 

7.4.8 

7.5.3 
7.5.3 
7.5.3 
7.5.3 



g' 
g' 

s' 



am' = g 

See E,20 Half-word Packing 

g' = g & "s 
g' s am 
g' = g V s 
bt' = g - s 



E.20 Half-word packing 

s has an 8-bit exponent and a 1 6-bit mantissa. 



1624 
1626 



7.4,8 
7.4.8 



5 
10 

9 
8 

7 
10 

9 

8 

16 

15 



10-31 

11 

3 

7 
12 

4 

3 

3 

3 

4 



5 
4 

3 

7-9 



am' = s 



am. with s rounded 



15! 
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E/9 



Extracod 


e Ref , 




Description 




Instructi< 


Dns 














Obeyed 




E.21 Funct 


ions and 


miscellaneous 


routines 










1700 


7*4.1 


am' 


= log s 






1701 


7.4,1 


am' 


= log aq 












1702 


7.4.1 


am' 


=t exp s 






43 






1703 


7,4.1 


am' 


= exp aq 






42 






1704 


7.4.2 


am' 


= integral part of 


s 


5 






1705 


7.4,2 


am' 


= integral part of 


am 


4 






1706 


7.4.2 


am' 


= sign s 






5''6 






1707 


7.4.2 


am' 


ss sign am 






4-5 






1710 


7.4.1 


am' 


= 4 ¥ 






Max 


42 




1711 


7.4.1 


am' 


= -slaq 






Max 


4i 




1712 


7,4,1 


am' 


= 4'aq9 + ~ 


i"5- 




Max 


50 




1713 


7.4,2 


am' 


= aq^ 












1714 


7.4.2 


am' 


= 1/s 






k 






1715 


7.4.2 


am' 


= l/am 






4 






1720 


7.4.1 
7.4.1 


am' 


= arc sin 


s {'^/2^^/2) 








1721 


am' 


= arc sin 


aq 










1722 


7.4,1 


am' 


= arc cos 


s (0<s<5r) 










1723 


7.4.1 


am' 


= arc cos 


aq 










1724 


7.4.1 


am' 


= arc tan 


s (""•/2<s<V2) 








1725 


7.4.1 


am' 


= arc tan 


aq 










1726 


7.4.1 


am' 


= arc tan 


(aq/s) (- 


ir< aq < ir) 








1727 


7.6.1 


See 


S.11 Test 


Instructions 








1730 


7.4,1 


am' 


= sin s 






4i 






1731 


7.4.1 


am' 


= sin aq 






40 






1732 


7.4.1 


am' 


= cos s 






42 






1733 


7.4.1 


am' 


= cos aq 






4i 






1734 


7.4,1 


am' 


= tan s 






34 






1735 


7.4.1 


am' 


= tan aq 






33 






1736) 


7.6,1 










-*' -^ 






1737) 


See 


E.11 Test 


Instructions 








1752 


7.4.3 


m' = 
t 


: aor, 8^2 
^ „ 0"" * 'i 


ay' = ay - 


- 12 


10 




i^) 


• / ^-z 


/ . -T . J 


iX JJ- 


= in, , 


ay' - au 


+ 12 


b 




^^) 


1754 


7.4,2 


Round am by_ adding; standardise 


6 






1755 


7.4,3 


aaj' 


= ax. S-y- 


"y; ay = 


ny 


17 




(X) 


1756 


7.4.2 


s' = 


: am, am' = 


■ 3 




8 






1757 


7.4.2 


am' 


= s/am 






k 






1760 


7.4.2 


am' 


2 
= am . ^ 






3 






1762 


7.4,3 


m' = 


1 2 

•ax, 8 , - 
= m. 8-^' 






9 




(x) 
(x) 


1763 


7.4.3 


a of 






5 




1764 


7.4.3 


arc' 


= ax. 8" 






17 




(x) 


1765 


7.4.3 


aaj' 


= aaj.S"" 

= Is 1 






12 




(X) 


1766 


7.4.3 


am' 






4 




(X) 
(X) 


1767 


7.4.3 


am' 


= lam 1 






3 




1771 


7.5.1 


b121 


' = Ba, b119' = N + 


ba + bm 


2 




\ / 


1772 


7.4,3 


m' = 


(m.sa?) 8 
(ax/ax) 8 
= am/s 


; ay' = 


ay + s y- 


12 11 




Si 


1773 

1774 


7.4.3 
7.4,2 


m' = 
am' 


ay-sy-12. 


ay' = 12 


27 
10 




1775 


7.4,2 


am' 


= aq/s 






9 






1776 


7.4.2 


Remainder 






13 
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F/i 



Appendix P 

Summary of Basic Instructiorxs by I^anction 



B-Line Operations 



106 ba' =ba ^T] 
116 s' =ba j^s I 
126 ba' =_ba. ^n 



Logic Operations 

|f47 ba^^ba'v^s! 
j 1 67 ba' = ba Y n; 






Cyclic Shifts 



1107 ba = bale's' 
■117 s' =ba .& s 
;127 ba' = ba cS= n 

'164 ba' = ba + (bm & n) 
:165 ba' -- bm & n 



145 ba' =.^-ba - s ' 
163 ba' = ^ba - n 

105 ba' = lei's ba 4- 3 
125 ba' =i4iba + n 



• 1 20 "ba ' = n - ba | 
H2I ba' =:n 
■ 122 ba' =ba - nj 
il23 ba' =-n 
j124 ba' = ba + n 


Index Arithmetic 




100 ba' = s ■- ba' 
^101 ba' = s ; 
!l02 ba' =ba - s 
^103 ba' =-s 
104 ba' = ba + s 


|110 s'' = s - ba 
.111 s' = -ba 
;112 s' = ba - s 
{115 s' = ba 
Ml4 s' = ba + s 



Set B-Test 

1 50 "bt ''= s "^a" j 
152 bt' =ba - s I 
! 
170 bt' = n - ba ' 
1 72 bt ' = ba - n ! 



Test Instructions 



Count 



:200 If bm^, then ba'=n and TMi'=bcn0.4 ■ 

j201 If bn^, then ba'=ii and bm'^ia+1,0.| 

1202 If bn^, then ba'.^ and bm'=biii-0.4 ; 

: 203 If bub^D- then ba'=n and bm '.:^!ii-i , 



220 If i5%i!^ then ba'=n and biii'=:a3Hi^0.4 
22-1 If htfk), then ba'=n and brn'r^im+LO 
222 If b-t^, then ba'=G and bni'=^m-0.4 



99.^ T-P -hi-.-ln +V,...r, -ho '. 



* i%m_H n 



{234 If aoMD, ba'^i214 If b2v.-=0, ba'.-a 

!235 If aa?74), ba'r^i215 If dl>^, ba'=ai 

;236 If &x>0, ba'=:n|216 If bm>0, ba'=^ 

237 If aa?<0, ba'=:di|2l7 If bin<0, ba'=ai 



Test 



1210 If bm odd, ba'=ja J224 If ht^C, b4'=n 

i211 if bm even, ba'=iii225 If bl^^), ba'=n 

1226 If bt>0, ba'=n 

( J227 If bt<0, ba'=ii 



(1.65) 



1/2 



Acciunulator Operations 



Unstandardised 
(Pseudo Fixed-Point) 



Standardised 
Floating-Point 



Pseudo Double-Length 



Rounded 



Unrounded 



Addition 
and 



330 a'=am+s AO i 320 am'=arir*-s ORE 



331 a'=arn-s AO 



300 a'=ajn+s QBE i 310 a*=am+s NQE 



321 ani'=ain-s QiM 301 a'=ara-s QE 311 a'=ajn-s NQe] 



Subtraction !332 a'=s-am AO J 3 22 ajn'-s-am QR E 302 a'=g-am QE | 



Transfers 
In 



J334. a'=s 

1335 a'=-s AO I 



324. a'=s Q i 3U am«=s N i 
325 a'=-s QE I 315 am»=-s NAOf 



I 344 l'=sa: 

;' 34.5 l'=S£am'=s3 ! 



Transfers 
Out 



34-6 s'=am,a'=0 



347 s'=al,l'=0 1 



^^ilti- [352 l'=ni.s EAO { 362 am'^ajTi.G QHE J342 a'=aJ!i.s Oj; i 372 a'=ajn.s EAO 
plication { 353 l^=-m.sEAO 1363 am'^am.sQHE [343 a^^am.sQJ E ) 373 a«=-am.sEAO 



Division '375 al'=*'a/| s| | 374 ara'=am/s 

I, ._ m»=rem E i 1»=0 QfiE DO 



376 al'=H-^|g| i 

m'=rem EDO [ 

377 al'=|am)/|sl i 

iii*=rem EDO \ 



Standard: 
sat ion 
and 
Rounding 

Octal 
Shifts & 
Moduli 

Check 

Exponent 

Overflow 



|36l aiii'=a RE 36O ain«=a QRE !340 a'=a QE ! 355 a'=al'.8"^*Q! 
i354 ajii'=Q ft^AO ~ " ' 



'364 a;c'=8aa; 
365 aa'=aa;/8 



341 a'=a E 



.^66 a' = 



, ami QE 

'367 a»=|s| QE 



AO Accumulator may overflovr 

N L not cleared 

R*- Rounded by adding 

O Cyclic Shift 



Q Accumulator standardised 

R Accumulator rounded 

E Exponent overflow may occur 

DO Division overflow may occur 
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iO 



11 



H.3 
0) -p 



12 



20 
241 



CO 

a 

o 

•H 

•P 

■P O 

EH -P 
03 



i 



"•3 



I 



O (Q 
^.3 



16 



17 







ba' 



j-ba 
5-ba 



Bo 



ba'^s^ 
= -ba 



2 



rr- 
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Instructions given in brackets are non-standard and should not normally 

be used. They are given here only for the sake of completeness. 

NA means that no x^gisters are altered as a result of these operations. 

However instructions desig:^ted "s-type" do make a store-reference 

and thus SVO or Non-equivalence may occur 
The "n-type" instructions do not make any store-reference, and are thus 
in effect dimimy instructions* 



E 
DO 
AO 
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Exponent overflow may occur 
Division overflow may occur 
Accumulator overflow may occur 

These division instructions are not 
fully described by the summary. 
Reference should b e made to Chapter 6 
before use« 
These ins time tions set B-carry 



CORRECTIOISllg AND ADDITIONS TO CS 348A 
Issue June I967 . 

The following list refers to a) facilities, described in 
the manual, which are not available, or are available in a 
different form; b) new facilities not mentioned in the manual. 
All relevant information contained in Atlas 1 System Programs 
Bulletins 1 to kl is included. 

Section . 

8.3 Carriage Control Characters 

The present ABL compiler expects to find only the following 
carriage control characters in the input stream: 0,1, 2.0 and 
2.1. The character is checked only for a 1 in bit I9, indicating 
carriage return, and a 1 in bit 23, indicating line-feed. 

This may affect programmers calling down ABL programs from 
magnetic tape, where carriage control characters may be other 
than those mentioned above. For example, control characters 
2.2 and 2,k will be treated like 2,0; 2,3 and 2,5 will be 
treated like 2,1, 



8,15 The Output Extracodes 

1070 Rename Output n as Input ba 

Only a limited form of this facility is available, using 
the contents of Ba, not Ba itself. After using the extracode, 
output stream n is deleted, and further reference to this stream 
is faulted; if output n was the selected output, output becomes 
the selected output, ILLEGAL FUNCTION will be caused in the 
following circumstances: 

(i) n = 

(ii) Input ba already defined 

Output n must be defined in the Job description (see 10.4.2) 
as destined for a private tape, or for any peripheral. 

Use of 1052 for input ba will indicate peripheral type 
J60041. 

If 1071, break output, has been used on output n, and a 
private tape is not being used, only the last section will 
be treated as input ba. Output n will not be listed in the 
supervisor printing at the end of the program, but input ba 
will. (See chapter ll) 
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8.6/5 
8,6.10 Reading a fixed-point number to B81; A2/L100, A7/I100. A6/L100 

The program enters a routine which first cleaiNS the 
accumulator, a digit count, and markers signifying 'Negative number', 
'Decimal point read', and 'Reading number'. A negative number is 
signified by a 1 in the l.s. bit of B^O. Characters are read from the 
reconstructed line; if the chai^acter is a digit, this is left at the 
l.s. end of the m.s. half of a full-word. The aocumulator is 
multiplied by 10 (or by 8 if a dec, pt. has been read), and the 
full-word, treated as a floating point number, added to it. Thus 
the partially assembled number is held in the accumulator (always 
as a positive number) ae its real value divided by a factor of 85. 

When the complete number has been read, the required 
part of the mantissa of the accumulator is picked out. If, in 
the form required, the number will not fit into a B-line, the 
program is monitored. The number is placed in B81, and negated 
if a negative sign has been read; the negative marker in B90 
is cleared. 



8.6,11 Reading a floating point number to the accumulator j A1/L100 

The number is built up in the accumulator in a manner 
similar to that described above; a digit is read, the accuaulator 
is multiplied by 10, and the digit added in. The correct exponent 
is found by noting the nimiber of digits following the decimal point, 
and reading the exponent between the brackets, if any. 

While the exponent between brackets is being read in to 
the accumulator, the number so far assembled is stored in A99/5101 L100, 
and the count of digits following the dec. pt. is stored in A51/3IOI L100 
(half-word). 
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8»17 Specification of LI 99 - LINE RECONSTRUCTION 

L199 is used by library routine LlOO (see 8.5;1 
and 12,7,1) but can be used by itself if desired, exactly 
like any other- library routine^ 

The following is a detailed specification of L199; 
General Points 

-*iv. ^«^x^i^j.wia ^^j. xjj.;^> xs bu reconsrrucT; xmes of 
information, placing each character in the least signi- 
ficant 7 bits of consecutive half words. 

The beginning of line reconstruction storage is 
A20/L199 and the layout of a reconstructed line is as 
follows:-?. 

(1) The first two full words are reserved for items 
other than characters (space used by LlOO) 

(2) The first character is placed in the first half 
word after (l) and the line reconstruction occupies 
consecutive half words, 

(3) The carriage control information NL, LF or PT is 
stored at the end of the reconstructed line, as a 
6-bit character in the half word following the last 
character (least significant 6 bits). 

Entry to L199 is at AI/LI99 with the link, in BBS; 
1) Single Line Reconstruction 

at A20/L199 (See Section lil); Before entry to L199 the 
programmer must set B83 and B84, 

B83 is set to the address, relative to the start of 
the line reconstruction space, of the half word preceding 
that of the first character in the line. Thus B83 is set 
equal to 1,4 for normal requirements; However, if the pro- 
grammer requires, for instance, multiple space before the 
first character, then B83 can be set accordingly, (increase 
B83 by 0,4 for each space required.) 

B84 is set to the address of the line reconstruction 
space relative to A20, thus for single line reconstruction B84 
is zero; 

l«l) Optional Parameters 

There are four parameter settings :- 

A20/L199 - Beginning of line reconstruction storage; 

A24/L199 - Maximum line length in characters 
(excluding carriage control) 
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8/17.2 

Ag5/L199 - Parameter to facilitate various Tab, 
settings, 

A26/L199 - Jump address in * Look-up table' for 
Tab, routine. 

Parameter settings in detail: 

A20/L199 - The programmer may allocate specific storage 

"Pry IT' T-rifi ooiiyiTiTinTicr <-»-p 1 -i vy r\ inc^r^ 'vr> s ■*-■•»-•■• .»»•*--; ^■•-^ w__ 
■^ -J ^ wiiv./ f ^^g-i-^A^A^aijg v^j. J.J.AJO jL o\^ wxj o o jL u.«.« L> JL Oj.1 uy 

setting e.g, A20/L199 = 100. If .A20/L199 is 
not set, A20 will follow after L199, 

A24/L199 - The maximum line length is assumed to be A24 = 
160 characters (excluding the carriage control 
information). The progreunmer may set A24/L199 
to facilitate a different line length. 

A25/L199 - The usual setting for A25/L199 is 15 which will 

give the Standard Tab. of 8, 8, 8, 8, I6, 16,06,,,, 
However, by setting either A25/L199 = -1 or 999 
the programmer can arrange for Tabs of I6, 16, 16, 
or 8, 8, 8, ,,,, respectively, 

A26/LI99 - During line reconstruction a standard routine for 
dealing with the character Tab. is labelled A26; 
This routine gives the Tab, settings explained 
above. Should the programmer wish to use a 
private routine to deal with Tab, then A26/L199 
must be set to the starting address of the private 
routine. 
Exit from the private routine must be to 1A28/L199 

All parameters are set on the first entry to L199, 

and B88 need be set. 

1-2) Layout of line reconstruction 

For single line reconstruction the first two full words 
A20 and 1A20 are used as follows :-- 

a) First half word - contains 0,1 if Line Feed or 
(A20) Paper Throw has been encountered 

by LI99 other thein at the beginning 
of a line. 

b) Second half word « blank (may be used by programmer for 
(0,4 A20) pointer storage when using a line). 



c 



) Third half word - contains Line Feed or Paper Throw 
(lA20) pointer for use on next entry to 

LI99. (Blank if Line Feed or Paper 
Throw absent from the line). 
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d) Fourtli half word - contains the maximum pointer for 
(1.4 A20) the reconstructed line (half 

word address) i.e. the address 

mation. 

The address of the first character is 2A20 for single 
line reconstruction, providing B83 is 1.4. 

1.3 ) Character form 

(1) The routine deals with Backspace and Tabulate, 
and these characters do not appear in the 
reconstructed line. 

The usual form of single characters is as 7-bit 
characters stored in the least significant ends 
of half words (bits 17-23). The 7th bit denotes 
either Inner Set (bit 17 zero) or Outer Set 
(bit 17 one). 

(2) Compound characters are built up as described in 
section 8.5.I. 

(3) The following characters are assigned special 
values by the line reconstruction routine 

Space, Sp marked 0.0 

Erase, Er marked Jk 

Fault, Ft marked J3 

Underline, Ul marked J2 

Figure Shift, FS marked Jl 



l.h) Faults 

The program is monitored andterminated: 

(1) If the maximimr liiie length A24 is exceeded 

(2) If the carriage control information at the 
end of a record is not in the range 0-5.7 

(3) If cin unassigned or spare character is 
encountered 

{k) If a compound character consisting of four 

or more characters, with or without Underline, 
is encountered. 

2) Multiple line reconstruction 

The programmer must set A20/L199 if more than two 
active lines are required. 

The details in Section 1 for single line reconstruction 
apply here, with the following additions. 
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When the programmer wishes to use several reconstructed 
lines during a program, all of them active, then storage must be 
allocated for these lines, This can be achieved solely by 
setting B83 and B84. 

As in the case of single line reconstruction, the first 
entry to L199 will initiate the optional parameter settings. 
These settings will now apply to all lines. 

The first line reconstruction space starts at A20/L19q 
with B83 set (usually l.k) and B84 zero. ' 

The second line reconstruction space will start at the 
address (A20/l199 + B84) where b84 (contents of B84) is given by: 

b84 = K = (A24Q2 + 3 ) M - 1 and 

B83 is set as described in Section 1, Note A24 is the maximum 
line length (excluding the carriage control information). 

The third line reconstruction will start at the address 
M0/LI99 . 2K), the fourth at (A20/L199) . 3K etc. where 2^ 
3K, are the contents of B84. 

For each new line reconstruction, B83 and B84 must be 
set by the programmer. (Normally B83 is set as b84 + TTfT) 

2,1) Faults 

The faults described in Section 1,4) apply here. 
3) Use of LlOO 

Programmers should bear in mind that LlOO (General 
Input Routine) calls L199, causing the optional parameters 
of LI99 to be set. 

In particular, note that 

A20/L199 = A20/L100 
A24/L199 = A24/L100 
A25/L199 = A25/L100 
A26/L199 = A26/L100 
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9.5.1 Mount Extracodes 
1010 Mount 

Allocate the number Ba to the tape .^hose title is stored 
in locations S onwards. If this tape is not available instruct 

eve'nTblf 2? O) T""' ^' • °" T^ available mechanism 'A must be 
even (bit 23=0) for calling 1" tapes to be mounted 

1007 Mount Next Reel of File 
Inoperative. 
1012 Mount on Channel K 
Inoperative as defined, 
above?^^ """ ""^^ exactly the, same effect as 1010 as defined 



9'5.2 Other Or ganizational Extraoodes 
1014 Write Title 

This^'Jitfe wii?^r ^^-^^ *i"^ "*°''^'^ ^" locations S onwards. 
dlsL^ted. ' """""" *° ^^""°" ° °' '"-^ *-P- -^-- it i- 

1015 Read Title 
fHi^i^*°^^/K l°^^*i°"« S onwards the title of tape Ba. This 

title will be that rear! f^r^nm o^^-i--:^^ r^ ,.1 ^,. . "^® 

unless a imZt ^,r4-^o~'J~ C"^"" -----wxa v^ wxitixi urie rape was mounted, 

unxess a 101^^ extracode has since been used, in which casf^ tb^ 
newly assigned title will be stored. 



10.6.1 Single Tapes 

section n^^ir^^^^r"" °P*i°"^l features in the magnetic tape 
section of the job description are not available:- 

Tape serial niamber preceded by asterisk 
Reference letters 

Assignment of logical channel by .K 
* indicating no write permit 

, .^Z^.''^^''^^*^^ "" appears in the specification of a tape 
title in a job description or object program, the following 
characters on the line will be printed as usual but not chfcked 

foIlow'thr'S^ '""l 'i*'" "'^"^ *^"' °" *^P-- «-"-- comments can 
loixow the character^, 
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For example: 

TAPE 1 SYSTEM TAPE 5^ USE RBP/lO 

requires a tape of title SYSTEM TAPE 5. 

TAPE 2 LONDON COMPILERS* WRITE PERMIT 
requires a tape of title LONDON COMPILERS. 

The following restrictions apply: 

1. The character * must follow immediately after the title 
proper - intervening spaces are not permitted. 

2. If used with the facility TAPE NEW in order to title 

a tape, the entire line including asterisk and comments 
will be written to tape 

3. If a tape called by such a sequence is pre-mounted it 
will not be accepted as the required tape. The deck on 
which it is mounted should be disengaged by the operator 
and re-engaged, 

k. No comment is permissible in the TAPE COMMON statement, since 
this specifies no tape title. It must be assumed by the 
operators that common and new tapes are to be mounted with 
writing permitted. 

5. A maximum of 31 characters (including the asterisk) will 
be printed on the tape oiserators teleprinter. 

6. Although not checked, the characters following * form 
part of the title written bylOl4, or read by 1015 . 



10.6.2 Files not available 
10.10.3 Data Files - not available 



10.11 Tape and Card Markers 
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10,11.5 The Marker I 



After ^**E an extended set of terminators is 
recognised by the Supervisor, namely; 

•^**A, -*<-*^C, ***I, ***p, **^x, **^Z 

The new terminator **^I means "Switch back to 
conversion to Internal Code"; the significance of 
the others is iinchanged, 

'-• A wj. j.v^v»cu. uy etiiy omor 

letter will be ignored, and incorporated in the 
input stream. 

Note that the Supervisor overwrites the terminator 
with a string of internal code 0? characters only 
when code conversion is being applied. For example, 
consider the following document: 

DATA 
F5025 EXAMPLE 
FIRST LINE 

***E 
SECOND LINE 

THIRD LINE 

FOURTH LINE 

**-)fp 

RUBBISH 

During input of this doaument only the two *^*E»s 
are overwritten; the following parts are stored in 
the machine in binary: 

SECOND LINE 

and 

FOURTH LINE 

RUBBISH 

•x--x--)(-2 

Card terminators have 7 and 8 punched in column 1, 
and a letter in column 80. Acceptable letters are: 

A,B,C,E,F,I,P,T,Z. 

If column 80 contains any other letter, or is blank, 
while column 1 contains a 7, 8 punchir^ the terminator 
7> 8 ,,,,Z is assumed. 
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The significance of the letters is the same as 

that for the corresponding tape markers. Note 

that the P marker has no effect, and the use of 

I when in internal code, or E when in binary, has no 

effect. 

Marker cards are stored in the input stream only 
after B or Fj when no terminators are recognised; 
the reader proceeds until its input hopper is 
empty. 
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10,12 Input and Output using Private Magnetic Tapes. 

Input peripheral to tape 

By means of suitable headings, information can be 
passed through an input peripheral directly to a private 
magnetic tape for subsequent input to a program or output 
to another peripheral. 

Permissible headings are: 

COPY TAPE n or PRIVATE INPUT n .,.,.. (i) 
Recording will start at block n (decimal) on magnetic 
tape, and the ending of the input document will cause 
the termination of the document on tape. 

COPY TAPE FREE or PRIVATE INPUT FREE (ii) 

Recording will start at block 1 on magnetic tape, and the 
ending of the input document will cause the termination of 
the document on tape. 

COPY TAPE n/m or PRIVATE INPUT n/m (iii) 

Recording will start at block n (decimal) on magnetic 
tape, and the edding of the input document will cause the 
last block of input to be linked to block m (decimal) on 
the tape, 

N,B. Heading (iii) is available only at London and 
Chilton, 

The heading is followed on the next line by the tape 
title; in the case of heading (ii), the title given will be 
written to a free tape. 

The resulting document on magnetic tape will have the 
heading and tape title erased, and will also have the next 
record erased. In the case of card or 7-hole paper tape 
input, this means that a spare card or new line should 
follow the tape title. In the case of five track Input, 
the tape title will be regarded as terminated by a carriage 
return, for example, and the following line feed will be 
deemed to be the next record, and will be overwritten, 

Warning Characters and input faults 

1) Warning Characters B, E, P are treated normally, implying 
switcli to binary decoding, and suppression of parity checking. 

2) Card reader faults (check read, card wreck, and card levels 
except aft'er warning sequence B) are treated normallyj the 
document continues when the reader is re-engaged, 

3) During the first block of input (before the request to 
mount the magnetic tape has be«i;made) tape reader faults 
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(parity and overdue) and warning character A cause the 
document to be abandoned, and warning characters T, F 
are treated normally; the document is continued when 
the input device is re-engaged. 

4) After the first block on input, when the requested 
magnetic tape is mounted, tape reader faults and warning 
character A terminate the document on magnetic tape, as 

for warning nhar>ao-f:cvr>c3 n 7. Uo -^-k, -: -k, ^ ^r,„ -i._„_ m -r^ 

and end of tape following warning character E cause the 
current block of information to be written to tape, even 
though it will not generally be a full block, and the 
address of the next block on tape is reported on the 
central operators teleprinter as 

(Tape Title) 
COPYING COMPLETE TO BLOCK (n) 

Where n is the block label of the next block of tape in 
octal . 

When input is continued, it will be recorded in block 
n onwards and will constitute part of the same document, 
the "break" being obscured from the user. Should it be 
required to repeat input, due, for example, to machine 
failure, a new document heading can be typed to cause 
input to start at block n, and input resumed from the last 
break point. 

Note that the monitoring "COPYING COMPLETED TO BLOCK n" 
gives the section n on the magnetic tape at which the next 
input document can be recorded; the two documents will then 
be combined as one. If it is disired to record the two 
documents separately the second input document should b^ 
recorded starting further along the tape (e.g. block n + l) 

Termination of magnetic tape document 

Warnin-g characters Z and C, and char*actex' A and tape 
reader faults in any but the first block., cause the document 
to be terminated on magnetic tape, and the input device to 
be returned to normal system use. A document is terminated 
on tape as follows :- 

The current input block is written to tape at block 
label b, say, and is linked on tape to the next block b+1. 
If heading (iii) has been used, the document will continue 
at b^pck n; on input to a program, the user will be unaware 
of any break. 

Should it be required to add to the document on tape, 
input can be resumed to block b+1, and this will then 
constitute a continuation of the document from block b. 

The writing of the terminator block at block b+1 poses 
some problems if partial overwriting of a section of an 
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input document is necessary. The following procedure 
is recommended:- 

a) If the original docioment has been separated by 
by use of 

COPY TAPE (n/m) 

headings, then each section can be reifritten 

block gap m-n is sufficient to accommodate the 
new section of input. If overwriting is 
expected, this technique is stronly to be 
recommended, unless its use is deemed to lengthen 
the document on magnetic tape unduly, 

b) If no gaps have been left and the new section is 
knowi to be the same length as the original section, 
the new section may be read in, terminated by 
warning character T. When copying is completed up 
to this warning character, the tape should be 
disengaged manually or by operator request. The 
reader can then be returned to normal system use 

by input of a terminating sequence with warning 
character Aj the tape will not be found and the 
effect will be to abandon the copying operation, 

c) If the new section may be longer than the old, it 
should be recorded on a different position on tape 
with a terminating link, to the following section. 
The previous section should then be linked to the 
start of the new section by overwriting word of 
the last block of the previous section with the 
address of the new section 

e.g. To overwrite a section occupying 
blocks 100-120 inclusive, input new section with 
heading 

COPY TAP1>- 300/121 

and alter word of block. 99 to 3OO (as a 2k bit 
integer) , 

Reading a tape by program 

A dociament recorded on tape by the above method may be 
used subsequently in a program as an input stream by including 
the following statements in the job description 

INPUT TAPE (a) / (b) / 

(n) (Any convenient title) 

TAPE 

(a) (Title of tape) 

(a) is the logical tape number, quoted both in the input 
statement ajid the tape statement. 

xb) is the address of the section on tape where reading is 
t o c ornm en c a , 
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(n) is the logical input stream number. It is followed by 
any title the user may wish; this title is not checked on 
tape, and is effectively ignored by the Supervisor. It 
must, however, be present in the job description for the 
sake of uniformity with direct input streams. 

The input stream so defined may be read by means of 
input extracodes. Reading will commence at the first 
record on section (b); it is thus possible to start reading 
part way through an input document, which may be useful in 
the event of a long input stream. Note that any headin^ 
is not decoded or spaced over; in particular no notice will 
be tate.en of any compiler statement occurring in this input 
document. A compiler statement must occur elsewhere in 
the job, otherwise the ABL compiler will be called to start 
the job. 

The private tape used in the above way may also be used 
by the program as a conventional tapw using tape extracodes. 
This would not normally be done until the input stream has 
been completely read, for the input extracodes will 
reposition the tape whenever a new block of input is required, 

Reading will start at the first character in the block 
specified in the job description. The type of input 
(determined by use of extracode IO52) will be the input 
device used to load the tape; if the tape has been privately 
created (e.g. as an output stream of a program) the type 
will read zero. 

The stream will step from block to block using the 
link in word to indicate the next block. If the tape 
is used privately as well, it will be repositioned whenever 
the next block of input is required. 

The information in the block is checked for validity 
on reading from tape. The input stream will be terminated 
at the end of the current block if 

Word is zero or negative or greater thaji 50OO (i.e. 
lixika.ge to our impexmissibi© b^look ) 

or Digit 7 of word 0,4 is one (indicating end of document). 

The stream will be terminated at the beginning of the 
current block if any record separator points outside the 
block. Implicitly, therefore, the block must end with 
a zero separator, and this is normally the end of information 
in the block. Thus the stream is terminated if a block is 
encountered which is not a permissible input stream. 

output to Tape from an Object Program 

An output stream may be written to a magnetic tape 
rather than output immediately by use of the output statement 

OUTPUT (n) TAPE (b)/(Final destination) (amount) 
(Title of tape) 

or OUTPUT (n) TAPE FREE/(Final destination) (amount) 
(Title of tape) 
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In the former case, output stream (n) will be written 
to the named tape starting at section (b). In the latter 
case, a new tape is used and the title specified is written 
to the tape; output is recorded from block 1 onwards. 

The final destination and amount of output are 
specified as for normal output streams. 

The tape used for output stream n may also be used 
as private tape 110+n in the object program; normally 
such use will precede use of the tape for output. The 
output extracodes assume the tape to be positioned 
correctly whenever a new block of oi^ut is generated, and 
hence, if used privately, the tape must be repositioned by 
the user before output. Only one output stream can be 
directed to any one tape. The tape so generated may be 
used as input data for a subsequent program, using the 
facility for using a tape as an input stream. In this 
case, the first records on the tape will comprise 

OUTPUT (n) 

(Title of job which created this output) 

and these will be the first records read by a program. 

If an output stream destined for magnetic tape is 
broken into sections by use of the break output extracode 
a new section on tape will be started after each break ' 
output. Each section of output will be printed subsequentlv 
as a separate document. 

Output from tape to peripheral 

A private output tape can be output to any peripheral 
~j ^^^ ^^ ^ o^c^^v-idxu. iJAugituu. rae aesLaing is supplied 
by the user. Alternative sections at the end of the 
program select the particular output device to be used. 
The heading consists of the following:- 

JOB t^^y convenient titley 
TAPE 1 (Title of magnetic tape) 
USE lie 
n (b)/0 

where (b) is the starting block address on tape in decimal. 
This job will halt until the output device is idle and will 
then initiate output from the named tape. The device will 
remain booked until the end of the current document, when 
any other normal output which has been accumulated will be 
output. 

The output is terminated by the line 
END AT BLOCK (b) 

where B is the next block address on tape in octal. If the 
output has been broken, each portion will be output independently. 
The next portion may be output subsequently by printing another 
document starting at section (b) from the same tape. 
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No record of this output is recorded in the restart 
block, and hence, in the event of a machine breakdown, the 
job should be read in again to restart printing. Brinting 
may be resumed at any block label B. 

A magnetic tape produced by direct input from a 
peripheral may be output directly onto any desired equipment 
The format of input and output tapes are identical. 
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Input or output tapes can, if required, by created by 
an object program using tape extracodes. The format of 
each block of 512 words is as follows :- 

Half-word 0: digits 0^23 next block addres on tape. 

If zero, indicates end of 
document (not necessarily 
conversely) 

Hilf-word 0.4 digit 7 = 1 if last block of document, 

otherwise. 



Remaining digits irrelevant. 



Half-words 1 to 

7.4: Irrelevant 



Half-words 8 to 

511.4; Records in internal code or binary. 

Each record comprises a half-word 
record separator followed by the 
record. 

The record separator contains; 

Digit 0: 1 if binary 

if internal code, 

jy±S±t li 1 If continuation of incomplete record 

at start of block, 
otherwise 

Digit 2: 1 if start of incomplete record at 

end of block, 
otherwise. 

Digits 12->23: Number of 6-bit characters in record 

(including carriage control character). 

The information comprises binary characters (2 per half- 
word) or internal code characters (4 per half-word) terminated 
by a 6-bit internal code carriage control character, indicating 
the following:- 

(6.67) 



10.12/7 

Digit 0: 1 if paper throw, 

otherwise 

Digit 1; 1 if carriage return, 

otherwise 

Digits 2-5: Niimber of line feeds or channel for 

paper throw. 

At the end of a block, any incomplete record is ended 
without any carriage control character but with digit 2 set 
to 1 in the record separator. There follows at least one 
zero half-word indicating end of information. The record 
is resumed at word 8 or the next block; word 8 contains a 
count of the remaining characters with digit 1 set to 1. 

A record separator with digit 9 = 1 is a dummy, indicating 
the peripheral equipment used for input, and is effectively 
omitted when the stream is read. 

Records and record separators follow sequentially until 
a zero separator is reached. Internal code records always 
start in inner set internal code. 



11.2) The Trapping Vector 

Re-entry to program after trapping 

It is risky to continue the program using the value of 
main control stored in the specified B-line. If the trap was 
entered during an extracode, main control will already have been 
advanced, and part of the extracode will be omitted. 



11.'^) Restarting and re-entering a program 

Extracode 1113; Restart, set restart address to n 

The restart extracode can be used to dump the main 
store blocks, B-lines, etc. of a program, either on to the 
system input tape or on to a private tape. 

If the dump is to a private tape, the extracode must 
be preceded by a 1115 extracode instruction. The last use 
of the 1115 extracode before a dump specifies: 

ba : the logical tape number of the private tape. 

n : the tape section used for the dump; the> 
dump will be to blocks n, n+1, etc. on 
the tape. The number of tape blocks used 
will equal the number of main store blocks 
of the program below address J^k, If n=0, 
the next dump, if any, will be to the system 
input tape. 

If, in the 1L13 instruction, n is negative, the program will 
end on doing the next restart. The monitoring "PROGRAM ENDS ON 
RESTART" will appear on output streeim 0, unless private input 
tapes were specified in the Job Description, in which case the 
program will end with "TAPE NOT DEFINED" . 

If the restart extracode is used to dump to the system 
input tape, the instruction will succeed only if a certain time 
h^3 elap.s,ed sin.cje the. la^t <i>ump, o-r the--Qrrriva-l of the- job <yrt 
the execute list. At present this time is 6 hours, so that 
effectively the facility for dumping to the system input tape is 
not yet available. 

The programmer can check whether a dump has been success- 
fully carried out by looking at B127 in the instruction following 
the 1113 extracode; for a successful dump, bit 23 of B127 is set 
to 1. 

If the 1113 extracode is used to dump to a private tape, 
the dump will always be successful, with the proviso that a 
maximum of 255 dumps (including the case of negative n) is 
allowed to any one program. This limit is necessary because 
each dump, even if to a private tape, requires 2 fresh sections 
of system input tape. It is londerstood that there must be 
sufficient room on the tape on which dumping takes place, £ind 
that a private tape used for dumping is one specified in the 
Job Description. 
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In the event of a restart, for example because of a 
machine fault, the program will be started from the beginning 
if the 1113 extracode has not been used. If the last success- 
ful use of 1113 was with non-negative n, the program will be 
restarted at the address n, after restoring the following parts 
of the job to their state when III3 was last successfully used: 

Main store blocks below J34 

B-lines 1 to 90, 98, 99 

Accumulator 

Input streams 

Currently selected input and output streams 

Records of the use of main store blocks, tape 

transfers, computing and execute time, monitor 
and trap addresses, state of process switch. 

A small amount is added to the computing time and 
execute time before the program is actually re-entered, but 
those tape transfers which are initiated by the dumping 
process itself are not counted. 

Those private magnetic tapes which were specified in 
the job description and which have not yet been released or 
disengaged are recalled automatically, but not repositioned 
except in the case of private input tapes. Other magnetic 
tapes, if needed, have to be asked for again, after the 
re-entry at n. 

On any successful use of the III3 extracode where n 
is non-negative, there is an automatic break output for each 
output stream, so output will not be lost on a restart. If n 
is negative, the programmer must do this himself if he wants 
to be sure of getting his output up to that point, 

A restarted job will have its compiler changed to 
"RESTART" . 
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12, l) Programmed Drum Transfers 

An extracode which reads block p from drums to core store 
is not obeyed immediately^ but is "Queued" by the Supervisor, 
and the object program proceeds normally. By the time the 
extracode comes to be obeyed, the object program may have 
progressed far enough to have changed relevant registers in 
the program. In order to avoid this, the extracode should be 
followed immediately by an instruction which accesses block p; 
this ensures that the program will not proceed until block p is 
available or the "Page Locked Down" trap is entered. 

A.i^ - y > Coinpiler and Supervisor Extracode s 

Overflow extracodes (II50, II51) are not available. 

Extracode 114?; Call Compiler 

Call compiler n. 

(i) If n is even (digit 23=0), then n will be interpreted 
as a compiler number, and the compiler in question will be called 
from the Supervisor Tape and entered at the address specified by 
ba. The numbering of the standard compilers is given in Part 1 
of the Operators* Manual (CS 4ll). 

After execution of the extracode, 
b91', digits - 10 = compiler number 

digits 11 - 23 = block address of title 

block of compiler on tape. 

This entry to the extracode will read the compiler directly 
into the object program rather than buffering it via supervisor 
store. The store limit will be reset to that specified in the 
job description or the standard for the first compiler used, or 
to the execution store if this is greater, before the compiler 
is read. 

(ii) If n is odd (digit 23 = l), the compiler will be 
called from block b of tape a, where: 

a = digits 15 to 21 of n 

" " to "^=; • 'd±g±t;s " ' 2 ±0 ±h n't n " 

The compiler will be entered at the address given by ba. 

After execution of the extracode, 
b91' , digits - 10 = O 

digits 11 - 23 = block address of title block of 

compiler on private tape. 

This entry to the extracode will set the store limit to be 
that stated for compile store in the job description, or, if none 
is stated, the standard compile store of the compiler first used. 
Thus when using Compiler Special, the store limit will be set up 
as the job description limit or 80 blocks, or to the execution 
store if this is greater. Note that former355 Call Private 
Compiler allowed expansion in store to the limit of the machine. 



12.1) Programmed Drum Transfers 

An extracode which re^ds block p from drums to core store 
is not obeyed immediatelyjt but is "Queued" by the Supervisor, 
and the object program proceeds normally. By the time the 
extracode comes to be obeyed, the object program may have 
progressed far enough to have changed relevant registers in 
the program. In order to avoid this, the extracode should be 
followed immediately by an instruction which accesses block p; 
this ensures that the program will not proceed until block p is 
available or the "Page Locked Down" trap is entered. 

1 O O ^ n ^^^-i T^«, ^ 3 O _! T7V,J 

-i-»- a y I \y ^.j 111^.1. J- Kp i,' a,x iKJ. OUL'tJi' V i S '_'i' n.y LrclCOCieS 

Overflow extracodes (ll30, 1151 ) are not available. 
Extracode 114?: Call Compiler 
Call compiler n. 

(i) If n is even (digit 23=0), then n will be interpreted 
as a compiler number, and the compiler in question will be called 
from the Supervisor Tape and entered at the address specified by 
ba. The niambering of the standard compilers is given in Part 1 
of the Operators' Manual (CS 4ll). 

After execution of the extracode, 
b91»,' digits - 10 = compiler number 

digits 11 - 23 = block address of title 

block of compiler on tape. 

This entry to the extracode will read the compiler directly 
into the object program rather than buffering it via supervisor 
store. The store limit will be reset to that specified in the 
job description or the stsmdard for the first compiler used, or 
to the execution store if this is greater, before the compiler 
is read. 

(ii) If n is odd (digit 23 = l), the compiler will be 
called from block b of tape a, where: 

a = digits 15 to 21 of n 
b = ciig-itrs 2 t^o ±k a^ n 

The compiler will be entered at the address given by ba. 

After execution of the extracode, 
b91', digits - 10 = 

digits 11 - 23 = block address of title block of 

compiler on private tape. 

This entry to the extracode will set the store limit to be 
that stated for compile store in the job description, or, if none 
is stated, the stemdard compile store of the compiler first used. 
Thus when using Compiler Special, the store limit will be set up 
as the job description limit or 80 blocks, or to the execution 
store if this is greater. Note that formerly Call Private 
Compiler allowed expansion in store to the limit of the machine. 



The Supervisor used 11^7 at the start of all programs, so 
the information is in b91 when a compiler is first entered. 
For both entries to the extracode, if ba = the compiler 
will be entered at the standard entry point, 

Extracode II3O: Read Working Store 

Read contents of half-word n of working store into ba. 

n is treated modulo 1024 

Useful quajitities which can be read by use of this extra- 
code, and in no other way, are as follows: 

n ba» 

15.4 Address of private monitor 

If not set, reads Jk 

21.0 No. of drum transfers ordered by the 

program (digits 0-21 ) 

21.4 No. of tape transfers ordered by this 

program (digits 0-23) 

22.0 No. of magnetic tapes reserved for this 

program (digits 0-2l) 

11.4 No. of records output on currently selected 

output stream 

This list may be extended in the future if further items 
are required to be read. 

Note that since most of the working store is used for 
supervisor working space, not immediately concerned with the 
current object program, varying results may be obtained if 
the extracode is used with values of n not listed above. 
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12,10 (Eonstants in Fixed Store 

The following is a list of constants in fixed store 
which programmers may find useful. It is possible, though 
unlikely, that the contents of the locations mentioned under 
"Full-word Constants" may be changed at some future date. 

Masks and half-word constants 



Address 



Contents in Octal 



2701 j4 



2713 J^ 

2714 J4 



2726 Jk 

2727 J^ 



2739 J^ 



77777777 
17777777 
03777777 
00777777 
00177777 
00037777 
00007777 
00001777 
00000377 

00000097 
00000017 
00000003 
00000000 

25252325 

57777777 
73777777 
76777777 
77577777 
77737777 
77767777 
77775777 
77777377 
77777677 
77777757 
77777773 
77777776 

4.0000000 
10000000 

02000000 
00400000 
00100000 
00020000 
00004000 
00001000 
00000200 
00000040 
00000010 
00000002 

40000000 



37777777 

07777777 
01777777 
00377777 
00077777 
00017777 
00003777 
00000777 
00000177 
00000037 
00000007 

00000001 

63146314 
37777777 

67777777 

75777777 
77377777 
77677777 
77757777 
77773777 
77776777 
77777577 
77777737 
77777767 
77777775 
00000000 

aoaooooo 

04000000 

01000000 
00200000 

00040000 

00010000 
00002000 

00000400 
00000100 
00000020 
00000004 
00000001 

60000000 
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Address 



27^0 Jk 



Constants in Octal 



2751 Jh 

2752 Jk 



2763J4 



30000000 
06000000 
01^00000 
00300000 
00060000 

00014000 
00003000 
00000600 

00000140 

00000030 
00000006 

00000000 

77777777 
00000000 
00000001 
00000000 
00000001 

77777776 

00000000 

00000050 
00000030 

00000010 
00000100 



14000000 
03000000 
00600000 

00140000 

00030000 
00006000 

00001400 

00000300 
00000060 
00000014 

00000003 

00000000 

77777777 
77777777 
00000001 
00000000 
77777777 
77777777 
00000060 
00000040 

00000020 
00000000 
00000000 



Character Masks 



Address 



548 j4 





j4 


Full-word ( 


Constants 


Addr< 


ess 





j4 


515 


j4 


l4lQ 


j4 


1420 


j4 


1421 


j4 


1422 


j4 


1480 


j4 


1481 


j4 


1483 


j4 


1484 


j4 


1755 


j4 


1757 


j4 


1830 


j4 


I831 


j4 



Contents in Octal 

77000000 00770000 
00007700 00000077 

00000000 00000077 

00007777 00777777 



Value 

+ 1/2 

+0 

1/(2 ) 

exp 13 arg 

+ 1/2 

-lA 
log8e 
logeS 
+ 2 
+ 1 
/2 

exp 26 art 
-1 
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12,11 N on- standard input/output codes 
(i) Nonestandard input codes 

The standard input codes on Atlas (5-track and 
7- track paper tape and cards) have been extended to 
cover I.C.T. 19OO 8-track codes as standard 8-track 
input. The standard input codes are now: 

5-track. tape: Sirius/Pegasus/Mercury code 
7-track tape: Atlas/Orion Plexowriter code 

(odd parity) 
«-track. tape: I.C.T. I900 8-track, code 

(even parity) 
Cards ; I.B.M. card code 

f^^^ Different codes are introduced by a warning marker 
(XXX on paper tape; 7, 8 in first column on cards) 
followed by an integer n in the range 2 to 8, The 
special case n=9 indicates a return to standard code 
Markers with n=0 or n=l are ignored. Switching to in 
unavailable code causes reversion to the standard code, 
for that medium. 

On paper tape, ^**n causes the reader to be 
disengaged; when it is re-engaged, reading will continue 
m code n for that medium. Further warning sequences 
may follow in the new code n; for example *^*T in the new 
code will be correctly interpreted. 

(N.B. - This does not apply to MUSE, where the ^** 
sequence must always be in standard code, but the marker 
letter must be in the code currently operative). 

The code may be changed by further XXXn combinations. 
The code will revert to standa-rH nr^t^c^ r^n ^^^^,,^4- ,•„» 

- — ^~ — ^.^^v^ x^j.j v^j.Ji v^ \j \AJ.l, o O JL .Lilt; 

warning characters Z or A, and on faults such as Parity, 
or Reader Overdue, and at end-of-tape following warning 
sequences XXXB and XXXF. In binary, following XXXE, 
XXSI causes reversion to the current code conversion; 
mark-&rs arpp^aring i-n a -binaTy sreqrtence f'ollowih'e: SS5EE 
must be punched in the code operative before the xxkE 
(except at MUSE, where the above comment applies). 
XXXn will be ignored following XXXE. 

A similar system applies for card input. The 
warning character is punchings 7, 8 in the first column, 
irrespective of the code currently operative. In the 
marker card switching to code n, the code number is punched 
m the last column of the card. In standard code, during 
conversion to internal code, an impermissible punching in 
^^ ^"-^f!^ column causes the card to be translated as binary, 
ihis will continue to apply during conversion from other 
codes. 
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The code numbers n are local to the particular 
medium, i.e. there are up to 7 codes for cards, 7 for 
5-holerpaper tape, 7 for 7-hole tape and 7 for 8-hole 
tape. Code numbering is standard for all Atlas 1 
installations, as far as the input facilities allow 
(see section iii below). 

The system does not include facilities for passing 
details of the input code used to compilers or object 

proe-rams- no-r ■Fr»T» ai i ^-i.T-ino' ^-i^^-v ,, j-_ _, .^ 

conversion tables. ^ ^ 

(il) Non-standard output codes 

Non-standard output codes are specified by means of 
the 1060 extracode, The specification of this extracode 
has been extended as follows. 

The address field (after modification) is interpreted 
as consisting of 

i) bit (the j4 bit) 

ii) bits 1-11 Tm) 

iii) bits 12-20 (n() 

iv) bits 21-23 (octal faction) 

m specifies the output code required for the stream, 

n specifies the output stream, as listed in the Job 
Description, 

The extracode always switches output to stream n. 
The value of m is consulted only if bit 0=1, otherwise it 
IS Ignored. When bit 0=1, stream n is selected, and code m 
IS invoked for stream n; code m will be used for the v/hole of 
stream n, including any output that may have been generated"" 
before the » code-change » 1060 for that stream. In this 
context, the scope of code m is limited by a 'Break Output* 
instruction; such as instruction has the effect of switching 
to. standard code, j>ut do«« not affect ouijput generated up to 
that point, A 1060 instruction with bit 0=0 may change the 
output stream, but will not cause a change from the output 
code currently operative on that stream. 

If the first 1060 instruction referring to a given stream 
has bit 0=0, standard code conversion is used, and will 
continue unless a 1060 instruction with bit 0=1 is 
encountered for that stream. 

If the octal fe.ction is odd (i.e. bit 23=l), bits 0=11 
are ignored, and subsequent output on stream n will be in 
binary. 
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The value of m must lie in the range to 63. 
m=0 indicates output in the standard code for the medium 
concerned. If code m is unassigned, or cannot be 
implemented on the medium concerned, it will be treated 
as m=0. 

There is only one set of output code numbers; each 
number refers to a specific code on a particular medium. 
The numbers correspond to the input code marker nximbers, and 
are given in section iii below. 

It is not possible to specify OUTPUT EIGHT HOLE in 
the Job Description, Output streams destined for eight- 
track, paper tape must have been listed under SEVEN HOLE in 
the Job Bescription, Eight tracks will be punched if the 
correct width tape is loaded in the tape punch, 

A facility is available to the operators for changing 
temporarily the "standard" output code on a particular 
peripheral. 

Non-binary output is held on output magnetic tapes 
in Atlas Internal Code, For Private Output, the output 
code specified in the program will not be recorded on the 
tape; facilities are available for allowing any output 
code to be specified during off-line output from tape to 
peripheral, 

(iii) Code Numbers 

Output Input 

5-track 

12 2 Elliott 803 5-track 

13 3 

14 k 

15 5 

16 6 

17 7 

18 8 

19 9 Standa^rd (Eerrajiti Sirius/Pegasus/ 

Mercyry) 
7- track 

22 2 I,C,T, 1900 standard without parity check 

23 3 (London & Chilton) Creedomat I.C.T. I5OO 

23 3 (Manchester) : Elliott 503 without parity 

check 

24 k (London & Chilton) 

2^ 4 (Manchester): KDF9 without parity check 

25 5 

26 6 

27 7 

28 8 

29 9 Standard (Atlas/Orion) 
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Output Input 

8-.track (input not available at Manchester) 

32 2 

33 3 Elliott 503 
3^ 4 KDF9 

35 5 

36 6 Friden standard code 

37 7 

^9 9 Standard (based on I.C.T. I900 code) 

Cards 

^2 2 I.C.T. 1900 

^3 3 I.B.M./36O (EBCDIC) 

^^ 4 ECMA code 

45 5 

46 6 
^7 7 
48 8 

^9 9 Standard (extended I.B.M. 48 ~ character 

BCDIC) 

Note ™ Blank entries indicate that code has not yet 
been assigned, 

- The I.C.T. 1900 8-track code is the same as the 
ASCII even-parity code. Odd-parity ASCII code 
can be read as code 2 in 7-track. 

- Programmers should always check the availability 
of non-standard codes at the installation 
concerned. 
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ADDENDUM TO CS 348A 
HALF INCH TAPE OPERATIONS 



Some Atlas installations are equipped with half inch 
tape mechanisms as well as the standard one inch tape. The half 
inch tape operations are described in the following sections. 
At present there is an upper limit of 4096 characters in a 
record, if no information is to be lost during a transfer, 
and this is described herein; this limit may later be 
extended to 32758 characters. 

Section Date of Issue 

9.8 Atlas Half Inch Tape 5.65 

9.9 Half Inch Tape Instructions 

9.9.1 The Selection Instructions 5.65 

9.9.2 The Transfer Instructions 6.67 

9.9.3 The Skip Instructions 5.65 

9.9.4 Other Instructions 6.67 

9.9.5 Summary of Half Inch Instructions 6.67 

9.10 Specification of the Atlas Half Inch Tape 
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9.8 Atlas Half Inch Tape 

Information on each magnetic tape is split up into 
sections or records, consisting of up to 4096 six bit characters 
each. Groups of records may be formed into a file, separated 
from other files by file marks - short, standard records recognised 

"hv TiarHtjaro - I'/hon 4-Via +a*-\*s •! o -P-! v-«4- -r^^-,,^^^^ ^ J. J_ jj-j T 

ready move forward and use the first record. As the records are 
of variable length, and the tape is not pre -addressed, it is 
very difficult to use particular records, unless these occur 
sequentially on the tape. The file marks enable unwanted 
files to be neglected without having to examine every record 
within them. 

Searching for file marks is a relatively slow process 
compared with the computing speed of Atlas, and the time taken is 
proportional to the length of tape traversed. Any search 
instructions should be given as early as possible in the program. 

The characters stored on the tape each have a parity 
bit associated with them - the programmer can chose whether 
this should give odd or even parity. The character themselves 
nay be in one of two forms: Binary Coded Decimal, (BCD) usually 
for input or output data, and normally vdth even parity, or pure 
Binary, usually with odd parity, when the tapes are used as an 
extension of the computer store. The characters may be packed 
with one of up to three densities on the tape. 
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9,9 Half Inch Tape Instnictions 

9.9.1 The Selection Instructions 

The tape which is required for processing is initially- 
selected by obeying a 1260 instruction, which also defines the 

half inch instructions apply to this tape, with the exception 
of the 1262 instruction. The tape number is that appearing in the 
job description, and is specified by the Ba digits of the 
instruction (O^Ba^l26), The maximum record length is specified by 
bits 12-20 of the singly-modified operand n; hence the longest 
record allowable is 512 Atlas words, or 4096 characters. The 
octal fraction of n determines the mode of transfer as follows :- 

bit 21-0 for odd parity 
^-- 1 for even parity 

bit 22 = if no code conversion is required (binary) 

= 1 if code conversion is required (BCD) 

bit 23 must be zero 

Thus, the inst2niction 

1260 42 48 

would select tape 42 to provide backing store, transfers being 
unconverted with odd parity, with a maximum of 384 characters in 
any record. 

1260 2 4.6 

would select tape 2 for B.C.D. even parity working, maximum record 
length 32 characters. 

It may often be necessary to find which tape is being 
used, for instance on entering a subroutine. Extracode 1261 will 
find the selected tape, mode, and record length. The contents of Ba 
\rill be set to the tape selected, stored in the half word position, 
bits 15-21. ba will be set to J4 if no half inch tapes are selected. 
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The record length and mode will be given in the same way as 
for the 1260 instruction, and will appear in the B-line specified 
in the half-word position (bits 15-21) of the singly modified 
operand n. Thus the instmction 

1261 10 llDl 

at the beginning of a routine, and 

121 121 10 
1260 122 11 

at the end would preserve the half inch tape selected on entry, 
together with the maximum record length and mode of transfer. 

Before any transfers take place, the instruction 
1256 must be obeyed to select the density of character packing 
on the currently chosen tape, using operand n as follows :- 

n -^ for low density, 200 characters per inch 
n == 0.4 for medium density, 556 characters per inch 
n = 1 for high density, 800 characters per inch 

This density applies to the selected channel and should 
not be changed between tape transfers. If an attempt is made to 
read a tape in a higher density than it has been written in, 
the situation may be irretrievable. Hence if a tape/.s 
density is unknown, it should be read first and low density 
selected. If the wrong density is selected, there will be a 
read failure, which may be trapped (see sections 9.11 and 11.2). 
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^■^•2 The Transfer Instniotions 

Records are written to the selected tape using the 1270 
extracode. The niamber of characters, specified by bits 12-23 
of ba, must not exceed the nujnber specified by the 1260 extracode. 
The first character transferred is taken from the address S, 

The 1274 instruction will read the next record 
from the tape. Ba must be 1; S specifies the character position 
to which the first character will be transferred. Thus 

1274 1 63.4 

will transfer the next record from tape to store, starting at 
address location 63.4. If S<0 there will be no storage of the 
record, providing a means of skipping records. If the number of 
words in the record is greater than the maximum specified by the 
1260 instruction, the tape will continue to more to the end of 
the record, but the excess words will be lost. 

The 1276 instruction sets ba to the number of characters 
transferred from the tape by the previous 1274 instruction reading 
from the currently selected half inch tape. This may be greater 
than the maximum length specified by the 1260 instructions, 
in which case characters will have been lost. 

9-9-3 The Skip Instructions 

^^^^^B readix^ and writing records, it is also possible 
to move the tape along without either operation occurring. Skipping 
one record forward is achieved by ^freading:' to a negative store 
address using 1274. The instruction 

1275 1 S 

where S is negative, will skip one record backwards. 

The tape is moved more quickly when searching for a file 
mark than y^en simply scanning each record, and so the 1257 
instruction allows this faster search either backward or forward 
along the tape; 1257 is also used to write a file mark at the 
current position of the selected tape. The operation performed 
depends on* the value of Ba as follows;- 
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Ba = 0, write a file mark 

Ba — X, searcxi forwards for a file znark, positioning 
the tape to read the record following it 

Ba = 2, search backwards for a file mark, positioning 
the tape to read the file mark. The short 
record forming the file mark must be skipped 
before reading the first record of the file; 
alternatively searching forward for a file 
mark will have the same effect. 

The tape may be rewound and positioned ready fo 
read the first record by obeying the instruction 

1267 

9.9.4 Other Instructions 

IVhen a program deals with data that may be either on 
one inch tape or on half inch tape it is aaoessary to know 
which is being used in a particular rtm. Obeying a 1262 
instruction will set ba according to the type of device that 
is listed as number n (singly modified operand) in the job 
description. Thus 

1262 10 6 

will set blO' = if device 6 in the job description is a one inch 

tape mechanism 

^= 0.4 if device 6 is a half inch tape mechanism 
= J4 if no device 6 is defined. 

The following instructions have a similar use for both 
one and half inch mechanisms. 

1010 Ifotint tape. For half- inch tape, although it will be 
called for by name, no check can be made that the 
correct tape is mounted. 

n must be even (bit 23=0) for 1* tape, odd (bit 23=1) 
for i" tape. 

If all i*' tape mechanisms are in use, the program 
will be monitored on Excess Becks. 
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1016 Unload and Store, 

Applies to i-" tape as to 1" tape (see sec. 9.5.2). 

If used for i* tape this extracode will deselect any 

selected ^ tape. 

If no 1" or h" tape Ba is allocated, the program tdll be 

monitored on Tape Not Defined. If there are a 1* 

and a i" tape both with the logical number Ba, the 

1* tape will be unloaded, 

1021 Release Mechanisms. 

9.9.5 Summary of Half Inch Tape Instructions 

1256 Select density n on selected mechanism 
n=0 low density, 200 ch/in. 

n-0.4 medium density, 556 ch/in. 
n=l high density, 800 ch/in, 

\There high density is not available, n-1 gives 
medium density. 

Reading in a higher density than the tape is written 
in has an iinpredicatable effect. Once the correct 
density is found, no further changes should be made. 

1257 Write filemark/Skip to file mark, using selected 
device, 

Ba = Write a file mark 

Ba - 1 Position the tape to read the record 

follo^ng the next file mark, moving 

the tape forwards, 
Ba = 2 Move the tape backwards to the previous file 

mark, positioning the tape to read the file 

mark. 
Ba > 2 Program is monitored on Illegal Function 

1260 Select deck Ba; define record length* and mode of 
transfer n. 

Ba must lie in the range O^Ba4l26. If no deck Ba is 
allocated, the program is monitored on Tape Not Defined. 

Bits 12-20 of n define the maximum record length. 
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Bit 21 of n for odd parit}'- 
'■'^ 1 otherwise 

Bit 22 of n ■--■ if no code conversion required 

1 otheri'/ise 
Bit 23 of n -^ always 

1251 Set ba to selected device; set b(n) to record length 
and node defined, 

ba^ ^- nurJDer of selected deck, in the half-word 
position, 
=-- J4 if no half- inch tape mechanism selected. 

The 3- register given in bits 15-21 of n is set to the 
record length and node as defined by the 1260 extracode. 

1262 Set ba to type of device n (bits 0-20). 
ba' ^- if device n is 1" tape 
- 0.4 if device n is ^" tape 
'- J4 if no device n is defined 

1267 F.ewind. 

Ifritten as 1267 0, 

I?ewind selected device. Position tape to read first 

record. 

1270 Vrite a record of ba characters from core store starting 
at S to selected device. 

If ba is s^ero, or exceeds the n^miber of character & 
defined hy 1260, the program will be monitored on Illegal 
Function. 

The extracode is much more efficient if S is a half-word 
address, and even more so if S is a block address. 

1274 ]Read a record to core store starting at S / Skip forward 
one record, using selected device, 
Ba must be 1. 

If the record is longer than defined by 1260, the extra 
characters will be lost. If S<0, there will be no transfer, 
only skipping. 

The extracode is much more efficient if S is a half-word 
address, and even more so if S is a block address. 

(6.&7) 
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1275 Skip backx-zard one record on selected device. 
3a must be 1, and S negative. 

127G Set ba to length of previous record read from 

selected device. If ba' is greater than the record 
length defined in 1260, characters have been lost. 

■•^^- ■ — —'<- — wv,>^j.>*rf.4.4^ wv^ j.<s^fy uiic; jLo-ou uxaj.icsj.er to core 

store from the selected device iiras ended, 
ba' - if end of record was not reached 
- 0.1 if end of record was reached. 



(6.67) 



9,1(25/1 



9,10 Specification of the Atlas Half Inch Tape System 
9.1C.1 Co ntrol 

An Atlas installation may have up to 6 half inch 
magnetic tape mechanisms, all connected to the computer through 
one channel, vrhich may be u&ed by one inch mechanisms 
in the usual way. This channel controls s read, write or 
backspace operation on one deck at an}'- one time. Hewind operations 
are autonomous, and need the channel only to initiate them, 
A search for a file mark is autonomous with any operations 
involving one inch mechanisms connected to the same channel. 

9.10,2 The Tape Layout 

The tape mechanism is the IBM 729 Mark IV or the Potter 
IITS 12C0{ - 41306, using half inch wide magnetic tape. There 
are seven tracks across the tape; six are used for data, and 
one for parity. There is no clock track provided; characters 
are recognised by the presence of a bit in at least one of 
the tracks. 

Information is stored on tape in blocks or records, 
which can be of any length, and are unaddressed. Because 
records are of variable length, selective overvrriting is 
virtually impossible. At the end of each record is one character 
generated from the parities of each track in the record; these 
parity characters are used to check the accuracy of all 
reading and vnriting operations. Records may be grouped into 
files separated by file marks - short records recognised by 
the hardware. 

Data is stored in two different character 
representations . 

a) Binary J4)de 

V/hen it is required to use the tape as a backing store 
to the computer, the data will be transferred to tape directly 
from the main store without any code conversion, i.e. in binary 
form. The parity track bits then ensure odd parity. 
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b) B.C.D. Mode 

\'Jhen it is required to use the tape as an input or 
output device, then alpha-numeric information will be required. 
The data is converted into Binary Coded Decimal (BCD) by 
the hardi^are; the parity track bits ensure even parity. 

Three densities of recording are possible: 200, 556 and 
800 characters per inch. Each record is separated from its 
neighJDour hy a ^/^" gap in which nothing is recorded. Tapes 
are up to 2400 feet long. 

9.10.3 Performance 

For the IBM deck, the normal tape speed is 112.5 inches 
per second, allowing instantaneous transfer rates of 22,500, 
62,500 or 90,000 characters per second for the low, medium and 
high densities respectively. There is a fast wind and rewind speed 
of about 500 inches per second; this speed is also used on 
long searches for file marks. For the Potter decks and normal 
tape speed is 120 inches per second giving instantaneous transfer 
rates of 24,000, 66,600 and 96,000 charr-cters p^,- second. The fast 
wind speed is 240 inches per second. 

There are independent read and write heads, separated by a 
gap of about 0.3 inches. It is possible to read or write when 
the tape is moving forv/ards only, although the tape may be 
backspaced a record at a time. 

9.10.4 Safeguards 

A program is held up if it attempts to read from or 
write to a block of store which is involved in a magnetic tape 
transfer. The Supervisor may then enter another program until 
transfer is completed. 

If a transfer cannot be initiated when it is requested, 
it is placed in queue; if this is already full, the program is 
held up, 

A write permit ring must be fitted to a reel of tape 
before that reel can be written on. Tapes containing permanent 
information will not have such a ring. 
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Because the tape's title is not written on the tape 
itself, the operator must ensure that the correct tape is 
mounted on the deck allocated; the Supervisor will assume 
that any tape so mounted will be the one requested. 
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9.11 Half Inch Tape Faults 

Half Inch Tape Faults will give rise to the monitoring 
IBM TAPE EPJROR n 

on output 0, where n gives the type of fault, n is also 
stored in B119. 

I2III Reason for monitoring 

^•^ Last record read by 1274 was 

a filemark. 

^■^ Reading parity failure. 

■^'^ End/beginning of tape detected 

following a 'write' or a 
'skip backwards' instruction. 

^•^ Writing parity failure 

^•^ Failure to detect a filemark. 

(Occurs only vrith 1257 instruction) 

2'^ No L.A.M. within 2 minutes on 

1257, 1267 or 1016, or within 
7 seconds on other instructions. 
Attempt to read a record longer 
than 4096 characters. 

3.4 

^■^ Mechanical failure on reading/writing. 

The first four of these faults (n^l.4) are trappable; 
trap entry 7 is defined as 

IBM TAPE ERROR. 

If the fault is trapped, B119 contains the value of n as given 
above. 

The following extracodes give Tape Not Defined if no 
tape has been selected: 1256, 1267, 1270, 1275, 1276, 1277. 



3.0 



(6.67) 



9.12/1 

9.12 Half Inch Magnetic Tape Code Conversion 

Code conversion between Atlas Internal Code and 
Binary Coded Decimal is provided for extracodes 1270 (Write) 
and 1274 (Head) if selected by 1260 with bit 22 of n - 1. 
The code conversion is as follows 

AIC BCD AIC BCD AIC BCD AIC BCD 

00 (00) 20 12 40 14 60 47 

01 20 21 01 41 61 61 50 

02 16 22 02 42 62 62 51 

03 17 23 03 43 63 63 22 

04 32 24 04 44 64 64 23 

05 52 25 05 45 65 65 24 

06 36 26 06 46 66 66 25 

07 37 27 07 47 67 67 26 

10 34 30 10 50 70 70 27 

11 74 31 11 51 71 71 30 

12 33 32 35 52 41 72 31 

13 53 33 75 53 42 73 56 
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AIC 


BCD 


AK 


(00) 
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65 


44 


55 


64 


44 


05 


25 


25 


66 


45 


56 


65 


45 


06 


26 


26 


67 


46 


57 


66 


46 


07 


27 


27 


70 


47 


60 


67 


47 


10 
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30 
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50 


61 
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50 


11 


31 


31 
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51 
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05 
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BCD AIC BCD AIC BCD AIC 
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02 



33 


12 


34 


10 


35 


32 


36 


06 
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13 
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55 


14 


55 
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BCD 


AIC 


73 


37 


74 


11 


75 


33 


76 


76 



0/ /4i 



Mote : 00 is unallocated in A.IC and is an unallowed character 
on tape, but is included in the above tables for completeness. 

00 with even parity should never be written to tape, 
as it cannot be read back. 
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10.6.4 Half Inch Tapes 

At those installations capable of handling half-inch 
(IBM-conpatible) magnetic tape, each tape required must be 
listed in the Job Description b-y means of a TAPE IBM heading, 
followed on a nex/ line by a description, consisting of the 

of the tape, e.g. : 

TAPE IBH 

42 F5025 FINCIILEY S.UES 

The deck allocation is treated in the same way as 
for one- inch tapes. Each tape used should have a different 

programmer's number. 
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.IPDSrriA TO CS 348A 
Issue July 1965 

Sectj.^n Sate of Issue 

7o4 ) Sxtracode instiniction tl-^ns ( 7.65 

7-5 ] I 7.65 

l.f, ) ( -7 Cc 

I ■' - ■ y^ I »\j } 

8.6.10 Reading a fixed noint numter to 
B81; A2/L100, AT/LIOO, AS/LIOO 

(new section) 7,65 

3.6.11 Reading a floating point number 
to the accumulator Al/LlOO 

(ne'^ section) 7.65 

8.1 .2 A?/L1, acruirule,tor exponent 7,65 

10.11,1 The Tape loarkers ***2,C,T,A 7.65 

12.5 ■'^ranching 7,65 



The number of basic instructions obeyed by some extracodes 
are given below. Special cases are normally excluded, but the 
extracode instruction is included, (The extracodes are also listed 
in Appendix E) 



Section 
'•4«1 Accumulator Exti^codes:* 

1700 47 1723 75-90 

1701 46 1724 38-53 

1702 44 or 53 1725 37-52 

1703 43 or 52 1726 44-61 

1710 36 1730 32-37 

1711 35 1731 51-36 

1712 41 1732 32-37 

1720 76-91 1733 31-36 

1721 75-90 1734 66-76 

1722 76-91 1735 65-75 

7 •4*2 Accumulator Extracodes :- 

1704 5 1754 6 

1705 4 1756 8 

1706 5-6 1757 5 

1707 4-5 1760 3 

1713 87-96 1774 11 

1714 5 1775 10 

1715 4 

1776 14 1466 21 

1407 15-30 1415 4 

1467 6+3ba 

7»4»3 Accumulator Extracodes s- 

1752 10 nr 13* 1767 3 

1753 5 1772 11 or 14* 
1755 18-26 1773 28-36 

1762 9 or 12* 1452 21-28 

1763 5 1473 26-33 

1764 15-23 1474 22-33 

1765 14-22 1475 21-32 

1766 4 1476 30-41 

*These figures assiune AO does not occur 



7«4.4 Double -Length Arithjnetic:- 
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Section 
7.4.5 



7.4.6 



7.4.7 



7.4.8 



7.5.1 



Address -Operand Arithmetic : - 



1520 
1521 
1524 
1525 
1534 



10 

11 

8 

8 

9 



1535 
1562 

1574 
1575 

1441 



Complex Arithmetic !- 



1400 

1403 
1410 

1411 
1412 

1413 



132-149 

109-128 
5 

90-93 

45-62 

43 
70-80 



1414 
1420 
1421 
1424 
1425 
1456 
1462 



10 
8 

17 

16 

6 



15 
8 
8 
6 
6 

5 

18 



Vector Arithmetic:- 
1430 4n+9 1434 



1431 4n+9 1436 

1432 4ri+9 1437 

1433 5n+10 
n is the nimiber of elements in the vector. 



3n+1irforwards) or 
3n+1 3 (backwards) 
5n+10 
I6n+10 



If n = there are special exits:- 
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1431 
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1436 
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1432 
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1437 


3 


1433 


4 






Half-word Packing s- 


. 
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1626 


7 


B-Regist 


er Arithmet 


;ic:- 




1302 


24-27 


1340 


12-24 


1303 


23-26 


1341 


1 1-23 


1304 


26-31 


1342 


10-19 


1312 


23-26 


1343 


9-18 


1313 


22-25 


1344 


12-23 


1314 


27-32 


1345 


11-22 


1547 
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1377 
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1353 
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1364 
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1356 
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1371 
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1357 
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1771 
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1376 


5 
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Character Data Processing s- 

1250 7-10 1252 ^+(14 to 17) 



1251 



1252 



11-18 



1253 3.75n+(l9 to 28) 



n is the number of characters. If n=0 there are 
special exits s- 

4 1253 3 
(7.65) 
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Logical Accimnilatoi 
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9-25 


1611 


3 




1265 


11 


1615 


3 




1601 


3 


1615 
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1604 
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I630 


5 




1605 


12 


1635 
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1606 
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1646 


3 




1607 
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1652 


6 or 8 
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Accumulator Tests j- 








1200 


9 


1237 


3 or 5 




1201 


7 


1727 


7 




1234 


11 or 12 


1736 


7 or 9 




1235 


11 or 12 


1737 


7 




1236 


4 or 6 
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The higher figure occurs when the condition 
is fulfilled. 



7.7 



8.10.2 A2/L1. 



B-Register Tests :- 






1206 4 

1216 4 or 5 

1217 4 or 5 


1226 
1227 
1225 


4-6 
3-5 

4 


Subroutine En try: - 






1100 6 

1101 5 


1102 
1362 


6 
3 



This entry to L1 to print the integer in 
B81 uses the accumulator without first clearing 
the exponent. 



10.11.1 The Tape Markers ^**Z,C,T,A 



On re-engaging a tape reader after ***A,T or Z, 
the next character is lost. On 5-track tape 
at least two figure shift characters should be 
punched following the marker, and before the next 
carriage return and line feed? on 7-track tape, 
the marker should be terminated by either upper 
case and newline, or two newlines. 



12.3 Branching 



Branching is terminated if only one branch 
remains active. If all branches are halted awaiting 
other branches, the program is faulted for EXCESS 
BRANCHES. 
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ADDENDUM TO CS 348A 
Version 6 of Atlas Basic Language 



1. Compiler Idgntifier 

The compiler prints an identifier at the head of output 0. 
This consists of the name and date of the current version of the 

comniler. p-a. 

_ — ^ ^ — _,, 

ABL6 1.8.66 
The identifier is followed by 5 new-line characters. It will 
be printed only when the compiler is first called from the 
Supervisor tape, and will not be repeated on a 'clean* re-entry 
to the compiler (at P120B), or during batch compiling. 

2. Input Routine 

The input routine of the compiler reads one record 
at a time from the input stream. 

3. AO of Routines and Libraries 

When H and L directives are encountered, the transfer 
address of compilation is automatically stepped on (if necessary) 
to the next full -word address. Thus AO of routines and AO/L 
of libraries will always be a full-word address. 

4» Source Program Listing: P105 

It is possible to li^t the source program as it is read 

by the compiler. The program is listed with each line optionally 
preceded by the current transfer address. 

Listing is controlled by P105, which is set as 

P105 = n:p.q 
or P105 = E, where E is any ABL expression which can be fully 
evaluated. The value of E is then interpreted as n:p.q. 

n is the number of the output stream on which the listing 

is required. This output stream must have been 

specified in the Job Description (except possibly 

for n = 0). 
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'2' bit 
'4' bit 



2. 

If output is chosen for source listing, the listing 
will be mixed with, and layout will be spoiled by, 
the optional printing controlled by PlOO and the 
compiler fault monitoring. 

controls the form of printing of the current transfer 
address, which precedes the listed line. This 
address is the location in which the first item on the 
current line of program will be planted (where 
applicable), p is an octal digit; each bit specifies 
whether a particular form of address is required: 
'1' bit : octal number, preceded by J 

block: word. character (always positive) 

integer. character (printed as negative above J4) 

Any, all or none of these forms will be printed, 
depending on whether the relevant bit is set to 1 (for 
printing) or 0, The printed address is enclosed in 
square brackets. 

The address printed is the transfer address of compilation 
before the line has been compiled . This means that in 
some cases this transfer address will be stepped on to an 
appropriate value after printing but before the item 
is planted. The listed address is the location in 
which the item will sit during execution, and not 
necessarily during compilation (as determined by the 
value of PllO). 

During listing, every non-empty line of program is 
listed preceded by an address; in the case of lines 
containing only directives, comments, spaces or erases 
the printed address will have no relevance. 

controls the format of the listed line: 

q = 1 or q - causes the line to be printed with all 
tabs replaced by the correct number of spaces in 
conformity with Atlas tab settings. 

q = 2 causes the input record to be output as one 
record. This form of output is much more economical on 
computer time than character output (i.e. q = 1), and 
should be used for paper-tape output, and any listing 
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of 5-track input. On the lineprinter, tab will be 
replaced by one space. 

On all lineprinter output, erase and backspace appear 
as full-stops. Erase is not edited out of listings. On five-track 
input, corrections may have been made by terminating a record 

^^^ *w^.w..iil wAiAjj., aii\^ u¥«iwjLii.i.ng. xne rinai result 

will be interpreted correctly in the listing. 

\fhile library routines are read in, following an RL 
directive, listing will be continued if previously requested, but no 
address precedes the listed line. 

During compilation of library routines, no listing 
will occur unless P105 is set within t he library routine. The 
scopes of P105 settings inside and outside library routines are 
quite distinct; when compilation of the main program is resumed, 
the previous value of P105 is restored. 

5. Parameter Listing: PI 14 

Preset parameter P114 controls the listing of all 
parameters mentioned in the program. The listing can be obtained 
in two ways: 

(i) Immediate l isting 

— 

If P114 is set with a 1 in the most significant bit, the 
listing is provided when the directive is compiled. 
The format is then 
P114 - n:pJ4 

n specifies the output stream on which the list is to 
be printed. 

p specifies the form in which the values of the parameters 
are to be printed. It is interpreted in exactly the same 
way as the 'p' setting in P105, i.e. 

'1' bit : octal number 

'2' bit : block: word. character (always positive) 
'4' bit : integer. character (printed as negative above J4) 
The general form of a line of the listing is 
Aa/bLc,d = value 7 gy 



4. 



Routine parameters are printed first, followed by those 
preset parameters up to P99 which are currently set. 
Global parameters will appear in the list immediately 
before the parameters of Routine of the main program. 

(ii) Listing on an Enter directive 

If P114 has a positive value when an Enter directive is 
encountered, the parameter list will be printed immediately 
before the program is entered. 

The format is 

P114 =--- nip.q 

and this may appear anywhere in the program. 

n and p are interpreted as described above. 

q specifies the occasions on which the listing is 
required; 



'1' bit - 1 
'2' bit = 1 
'4' bit - 1 



listing on EX 
listing on ER 
listing on E 

The listing will be appear if, for any reason, there 
is no attempt to enter the program (e.g. errors in 
program ) . 

Note that if any library routines (including public 
library routines) have been compiled before the parameter 
list is printed, all the routine parameters of the libraries 
will be included in the list. 

Routine parameters may be listed as "UNSET" or "SEMISET' 
the following notes v/ill help to explain these terms. 

AO of a routine is marked "semiset" as soon as an R 
directive is encountered. AO of Routine is 
marked "semiset" when the compiler is entered. AO 
will be marked "set" when it can be given a value, i.e. 
when the first item of that routine can be planted in 
the program area. 
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If reference is made to A3/5, for example, and 
Routine 5 has not been explicitly introduced 
by an R directive, parameter AO/5 is added to the 
parameter list and marked as "unset". A subsequent 
"RS" directive may then cause AO/5 to be set. 

■r>_ _- i I . . 

are initially marked as "unset". An attempt to 
set them will be made only on an Enter directive. 
On an EX directive, the parameters will be evaluated 
and marked "set" if possible; otherwise they will 
be marked "semiset". On E and ER directives, the 
parameters will be "set", either by evaluation or by 
assigning them the value J36, (=1920:0). 

Parameters set explicitly, e.g. A4 - A5, are marked 
as "semiset" until they can be evaluated. If A5 
is still "unset" when an E or ER directive is 
encountered, and A4 cannot be evaluated, A4 will 
be marked "set" and given the value J36. 

6. "Replacement" Parameter; P116 

P116 may be set in the normal v/ay, i.e. PI 16 = E, 

_ — ^^,j ^^^^ cAjt-'j.'cooxv^n wiijLVjiAi. <jicui jue jTUiiy evaiuaxea. JJuring 

the rest of the compilation, the value of P116 will be the contents of 
location ^£^ and not 'E' itself. The setting of P116 will give 
rise to Supervisor monitoring if store location 'E' is in an 
inaccessible area of store, or if the expression E cannot be fully 
evaluated, 

P116 may be reset during compilation. 

7. Program Dump: "^" Directive 

The contents of any area of store may be listed during 
compilation by means of the "i" directive. 

The format is 

iEl, E2 
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where El and E2 are any ABL expressions which can be fully 
evaluated, separated by comma or multiple space. 

I'/hen this directive is encountered during compilation, 
the compiler will list the contents of locations El to E2 
inclusive, in the form 

Address H Jx Jy 

where the address is printed in block: word form, enclosed in 
square brackets; x and y are the contents of the two half-words 
at that address, printed as 8 -bit octal numbers. A blank line 
is output after every 8 lines of listing. 

Supervisor monitoring will eventually occur if an 
attempt is made to read from an inaccessible area of store, or if 
El or E2 cannot be fully evaluated. 

This listing will appear on the currently selected 
output, normally output during compilation. 

Note that this directive is not available in programs 
punched on 5 -track tape or cards, as the *i* character is not 
represented in these media. 

8. Compiler size 

The si25e of the compiler itself is 4 blocks. The compiler 
as called from the Supervisor tape includes the public library- 
routines, and its size varies among the installations. 



D.E. Cronin 
June 1967 
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